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Foreword 

This Technical Specification has been produced by the 3"* Generation Partnership Project (3GPP). 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 
where: 

X the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 



Introduction 

The present document is part 3 of a multi-part TS covering the 3"* Generation Partnership Project: Technical 
Specification Group Core Network; Open Service Access (OSA); Application Programming Interface (API), as 
identified below. The API specification (3GPP TS 29.198) is structured in the following Parts: 



Part 1: Overview 

Part 2: Common Data Definitions 

Part 3: Framework 

Part 4: Call Control SCF 

Part 5: User Interaction SCF 

Part 6: Mobility SCF 

Part 7: Terminal Capabilities SCF 

Part 8: Data Session Control SCF 

Part 9: Generic Messaging SCF (not part of 3GPP Release 4) 

Part 10: Connectivity Manager SCF (not part of 3GPP Release 4) 

Part 1 1 : Account Management SCF 

Part 12: Charging SCF 



The Mapping specification of the OSA APIs and network protocols (3GPP TR 29.998) is also structured as above. 

A mapping to network protocols is however not applicable for all Parts, but the numbering of Parts is kept. 
Also in case a Part is not supported in a Release, the numbering of the parts is maintained. 



Table: Overview of the OSA APIs & Protocol Mappings 29.198 & 29.998-family 



OSA API specific^^^^^^^^^^V 


OSA A^^^^^^^^^^^^^^^^^H 


29.198-1 


Part 1 : Overview 


29.998-1 


Part 1 : Overview 


29.198-2 


Part 2: Common Dala Delinitions 


29.998-2 


Not Applicable 


29.198-3 


Part 3: Framework 


29.998-3 


Not Applicable 


29.198-4 


Part 4: Call Control SCF 


29.998-4-1 


Subpart 1 : Generic Call Control - CAP mapping 


29.998-4-2 




29.198-5 


Part 5: User Interaction SCF 


29.998-5-1 


Subpart 1 : User Interaction - CAP mapping 


29.998-5-2 




29.998-5-3 




29.998-5-4 


Subpart 4: User Interaction - SMS mapping 


29.198-6 


Part 6: Mobility SCF 


29.998-6 


User Status and User Location - MAP mapping 


29.198-7 
29.198-8 


Part 7: Terminal Capabilities SCF 
Part 8: Data Session Control SCF 


29.998-8 


Data Session Control - CAP mapping 


29.198-9 


Part 9: Generic Messaging SCF 


29.998-9 


Not Applicable 


29.198-10 


Part 10: Connectivity Manager SCF 


^9.998-10 
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29.198-11 


Part 1 1 : Account Management SCF 


29.998-11 


Not Applicable ^^^^^^^^^^^^B 


29.198-12 


Part 12: Charging SCF 


29.998-12 


Not Applicable ... 
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1 Scope 

The present document is Part 3 of the Stage 3 specification for an Application Prograniming Interface (API) for Open 
Service Access (OSA). 

The OSA specifications define an architecture that enables application developers to make use of network functionality 

through an open standardised interface, i.e. the OSA APIs. The concepts and the functional architecture for the OSA 
are contained in 3GPP TS 23.127 [3]. The requirements for OSA are contained in 3GPP TS 22.127 [2]. 

The present document specifies the Framework aspects of the interface. All aspects of the Framework are defined in the 
present document, these being: 

• Sequence Diagrams; 

• Class Diagrams; 

• Interface specification plus detailed method descriptions; 

• State Transition diagrams; 

• Data definitions; 

• IDL Description of the interfaces. 

The process by which this task is accomplished is through the use of object modelling techniques described by the 
Unified ModelUng Language (UML). 

This specification has been defined jointly between 3GPP TSG CN WG5, ETSI TISPAN and the Parlay Group Inc., in 
co-operation with a number of JAIN™ Community member companies. 



2 References 

The following documents contain provisions which, through reference in this text, constitute provisions of the present 
document. 

• References are either specific (identified by date of pubUcation, edition number, version number, etc.) or 
non-specific. 

• For a specific reference, subsequent revisions do not apply. 

• For a non-specific reference, the latest version applies. In the case of a reference to a 3GPP document (including 
a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same 
Release as the present document. 

[1] 3GPP TS 29.198-1 "Open Service Access; Application Progrannming Interface; Part 1: 

Overview" . 

|2] 3GPP TS 22.127: "Stage 1 Service Requirement for the Open Service Access (OSA) (Release 4)". 

[3] 3GPP TS 23.127: "Virtual Home Environment (Release 4)". 

[4] IETF PPP Authentication Protocols - Challenge Handshake Authentication Protocol [RFC 1994, 

Augustl996]. 
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3 Definitions, symbols and abbreviations 

3.1 Definitions 

For the purposes of the present document, the terms and definitions given in TS 29.198-1 [1] apply. 

3.2 Abbreviations 

For the purposes of the present document, the abbreviations given in TS 29.198-1 [1] apply. 

4 Overview of the Framework 

This clause explains which basic mechanisms are executed in the OSA Framework prior to offering and activating 
applications. 

The Framework API contains interfaces between the Application Server and the Framework, and between Network 
Service Capability Server (SCS) and the Framework (these interfaces are represented by the yellow circles in the figure 
below). The description of the Framework in the present document separates the interfaces into two distinct sets: 
Framework to Application interfaces and Framework to Service interfaces. 



Client Application 




Call 
Control 



Mobility 



UI 



Registered Services 



Figure: 

Some of the mechanisms are applied only once (e.g. establishment of service agreement), others are applied each time a 
user subscription is made to an application (e.g. enabling the call attempt event for a new user). 

Basic mechanisms between Application and Framework: 

Authentication: Once an off-line service agreement exists, the application can access the authentication 
interface. The authentication model of OSA is a peer-to-peer model, but authentication does not have to be 
mutual. The application must be authenticated before it is allowed to use any other OSA interface. It is a policy 
decision for the application whether it must authenticate the framework or not. It is a policy decision for the 
framework whether it allows an application to authenticate it before it has completed its authentication of the 
application. 
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Authorisation: Authorisation is distinguished from authentication in that authorisation is the action of 
determining what a previously authenticated apphcation is allowed to do. Authentication shall precede 
authorisation. Once authenticated, an application is authorised to access certain SCFs. 

- Discovery of Framework and network SCFs: After successful authentication, applications can obtain available 

Framework interfaces and use the discovery interface to obtain information on authorised network SCFs. 
The Discovery interface can be used at any time after successful authentication. 

- Establishment of service agreement: Before any application can interact with a network SCF, a service 
agreement shall be established. A service agreement may consist of an off-line (e.g. by physically exchanging 
documents) and an on-line part. The application has to sign the on-line part of the service agreement before it is 
allowed to access any network SCF. 

- Access to network SCFs: The Framework shall provide access control functions to authorise the access to SCFs 
or service data for any API method from an application, with the specified security level, context, domain, etc. 

Basic mechanism between Framework and Service Capability Server (SCS): 

Registering of network SCFs. SCFs offered by a SCS can be registered at the Framework. In this way the 
Framework can inform the Applications upon request about available SCFs (Discovery). For example, this 
mechanism is applied when installing or upgrading an SCS. 

The following clauses describe each aspect of the Framework in the following order: 

• The sequence diagrams give the reader a practical idea of how the Framework is implemented. 

• The class diagrams clause shows how each of the interfaces applicable to the Framework relate to one another. 

• The interface specification clause describes in detail each of the interfaces shown within the class diagram part. 

• The State Transition Diagrams (STD) show the transition between states in the Framework. The states and 
transitions are well-defined; either methods specified in the Interface specification or events occurring in the 
underlying networks cause state transitions. 

• The data definitions clause shows a detailed expansion of each of the data types associated with the methods within 
the classes. Note that some data types are used in other methods and classes and are therefore defined within the 
common data types part of the present document (29.198-2). 

4.1 General requirements on support of methods 

An implementation of this API which supports or implements a method described in the present document, shall 
support or implement the functionality described for that method, for at least one valid set of values for the parameters 
of that method. 

Where a method is not supported by an implementation of a Framework or Service interface, the exception 
P_METHOD_NOT_SUPPORTED shaU be retumed to any call of that method. 

Where a method is not supported by an implementation of an Application interface, a call to that method shall be 
possible, and no exception shall be returned. 



5 The Base Interface Specification 
5.1 Interface Specification Format 

This clause defines the interfaces, methods and parameters that form a part of the API specification. The Unified 
Modelling Language (UML) is used to specify the interface classes. The general format of an interface specification is 
described below. 
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5.1.1 Interface Class 

This shows a UML interface class description of the methods supported by that interface, and the relevant parameters 
and types. The Service and Framework interfaces for client applications are denoted by classes with name Ip<name>. 
The callback interfaces to the applications are denoted by classes with name IpApp<name>. For the interfaces 
between a Service and the Framework, the Service interfaces are typically denoted by classes with name IpSvc<name>, 
while the Framework interfaces are denoted by classes with name IpFw<name> 

5.1.2 Method descriptions 

Each method (API method "call") is described. Both synchronous and asynchronous methods are used in the API. 
Asynchronous methods are identified by a 'Req' suffix for a method request, and, if applicable, are served by 
asynchronous methods identified by either a 'Res' or 'Err' suffix for method results and errors, respectively. To handle 
responses and reports, the application or service developer must implement the relevant IpApp<name> or 
IpSvc<name> interfaces to provide the callback mechanism. 

5.1.3 Parameter descriptions 

Each method parameter and its possible values are described. Parameters described as 'in' represent those that must have 
a value when the method is called. Those described as 'out' are those that contain the return result of the method when 
the method returns. 

5.1.4 State Model 

If relevant, a state model is shown to illustrate the states of the objects that implement the described interface. 

5.2 Base Interface 

5.2.1 Interface Class Iplnterface 

All application, framework and service interfaces inherit from the following interface. This API Base Interface does not 
provide any additional methods. 

«lnterface» 
Iplnterface 



5.3 Service Interfaces 
5.3.1 Overview 

The Service Interfaces provide the interfaces into the capabilities of the underlying network - such as call control, user 
interaction, messaging, mobility and connectivity management. 

The interfaces that are implemented by the services are denoted as 'Service Interface'. The corresponding interfaces that 
must be implemented by the application (e.g. for API callbacks) are denoted as 'Application Interface'. 
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5.4 Generic Service Interface 
5.4.1 Interface Class IpService 

Inherits from: Iplnterface 

All service interfaces inherit from the following interface. 

«lnterface» 
IpService 



setCallback (applnterface : in IplnterfaceRef) : void 

setCallbackWitlnSessionID (applnterface : in IplnterfaceRef, sessionID : in TpSessionID) : void 



Method 

setCallback 

This method specifies the reference address of the callback interface that a service uses to invoke methods on the 
application. It is not allowed to invoke this method on an interface that uses SessionlDs. 

Parameters 

applnterface : in IplnterfaceRef 

Specifies a reference to the application interface, which is used for callbacks 
Raises 

TpCommonExceptions , P_INVALID_INTERFACE_TYPE 



Method 

setCallbackWithSessionID () 

This method specifies the reference address of the application's callback interface that a service uses for interactions 
associated with a specific session ID: e.g. a specific call, or call leg. It is not allowed to invoke this method on an 
interface that does not use SessionlDs. 

Parameters 

applnterface : in IplnterfaceRef 

Specifies a reference to the application interface, which is used for callbacks 
sessionID : in TpSessionID 

Specifies the session for which the service can invoke the application's callback interface. 
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Raises 

TpCommonExceptions, P_INVALID_SESSION_ID, P_INVALID_INTERFACE_TYPE 



6 Framework Access Session API 
6.1 Sequence Diagrams 

6.1 .1 Trust and Security Management Sequence Diagrams 
6.1 .1 .1 Initial Access for trusted parties 

The following figure shows a trusted party, typically within the same domain as the Framework, accessing the OSA 
Framework for the first time. Trusted parties do not need to be authenticated and after contacting the Initial interface the 
Framework will indicate that no further authentication is needed and that the application can immediately gain access to 
other framework interfaces and SCFs. This is done by invoking the requestAccess method. 



IpClientAPILerel Authentication 



Client 



: iDlnitial 


IpAPiLevelAuthentication 


: loAccess 


Frameworl^ 









1: initiateAuthentication( 



2: authentidationSucceecled( ) 



3: requestAcoess( 



1 : The Client invokes initiateAuthentication on the Framework's "public" (initial contact) interface to initiate the 
authentication process. It provides in turn a reference to its own authentication interface. The Framework returns a 
reference to its authentication interface. 

2: Based on the domainID information that was supplied in the Initiate Authentication step, the Framework knows it 
deals with a trusted party and no further authentication is needed. Therefore the Framework provides the authentication 
succeeded indication. 

3: The Client invokes requestAccess on the Framework's API Level Authentication interface, providing in turn a 
reference to its own access interface. The Framework returns a reference to its access interface. 



6.1.1.2 Initial Access 

The following figure shows a client accessing the OSA Framework for the first time. 

Before being authorized to use the OSA SCFs, the client must first of all authenticate itself with the Framework. For 
this purpose the client needs a reference to the Initial Contact interfaces for the Framework; this may be obtained 
through a URL, a Naming or Trading Service or an equivalent service, a stringified object reference, etc. At this stage. 
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the client has no guarantee that this is a Framework interface reference, but it to initiate the authentication process with 
the Framework. The Initial Contact interface supports only the initiateAuthentication method to allow the authentication 
process to take place. 

Once the client has authenticated with the Framework, it can gain access to other framework interfaces and SCFs. This 
is done by invoking the requestAccess method, by which the client requests a certain type of access SCF. 



IpClientAP I Level Authentication 



: ipinitial 



: IpAPILeveiAuthentication 



1 ; initiateAuthentication( ) 



2: selectEncryptionMethod( } 



3: authenticate( ) 



4: authenticationSucpeeded( ) 



5: ailjthenticate( ) 



6; authentiCationSucceeded( ) 



7: requestAcceSs( } 



:iobtainlnterface( ) 



: ipAccess Frameworl< 



1 : Initiate Authentication 

The client invokes initiateAuthentication on the Framework's "public" (initial contact) interface to initiate the 
authentication process. It provides in turn a reference to its own authentication interface. The Framework returns a 
reference to its authentication interface. 

2; Select Encryption Method 

The client invokes selectEncryptionMethod on the Framework's API Level Authentication interface, identifying the 
encryption methods it supports. The Framework prescribes the method to be used. 

3: Authenticate 

4: The client provides an indication if authentication succeeded. 

5; The client and Framework authenticate each other. The sequence diagram illustrates one of a series of one or more 
invocations of the authenticate method on the Framework's API Level Authentication interface. In each invocation, the 
client supplies a challenge and the Framework returns the correct response. Alternatively or additionally the 
Framework may issue its own challenges to the client using the authenticate method on the client's API Level 
Authentication interface. 

6: The Framework provides an indication if authentication succeeded. 
7: Request Access 
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Upon successful (mutual) authentication, the client invokes requestAccess on the Framework's API Level 
Authentication interface, providing in turn a reference to its own access interface. The Framework returns a reference 
to its access interface. 

8: The client invokes obtainlnterface on the framework's Access interface to obtain a reference to its service discovery 
interface. 



6.1.1.3 Authentication 

This sequence diagram illustrates the two-way mechanism by which the client and the framework mutually authenticate 
one another using an underlying distribution technology mechanism. 



Client 



Iplnitial 



Framework 



IpAuthentication 



1: initiateAuthentication( 



2: requestAccess( ) 



Underlying Distribution 
Technology Mechanism is used 
for application identification and 
authentication. 



3: obtainlnterface( ) 



bAccess 



1: The client calls initiateAuthentication on the OS A Framework Initial interface. This allows the client to specify the 
type of authentication process. In this case, the client selects to use the underlying distribution technology mechanism 
for identification and authentication. 

2: The client invokes the requestAccess method on the Framework's Authentication interface. The Framework now 
uses the underlying distribution technology mechanism for identification and authentication of the client. 

3: If the authentication was successful, the client can now invoke obtainlnterface on the framework's Access interface 
to obtain a reference to its service discovery interface. 



6.1 .1 .4 API Level Authentication 

This sequence diagram illustrates the two-way mechanism by which the client and the framework mutually authenticate 
one another. 

The OSA API supports multiple authentication techniques. The procedure used to select an appropriate technique for a 
given situation is described below. The authentication mechanisms may be supported by cryptographic processes to 
provide confidentiality, and by digital signatures to ensure integrity. The inclusion of cryptographic processes and 
digital signatures in the authentication procedure depends on the type of authentication technique selected. In some 
cases strong authentication may need to be enforced by the Framework to prevent misuse of resources. In addition it 
may be necessary to define the minimum encryption key length that can be used to ensure a high degree of 
confidentiality. 
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The client must authenticate with the Framework before it is able to use any of the other interfaces supported by the 
Framework. Invocations on other interfaces will fail until authentication has been successfully completed. 

1) The client calls initiateAuthentication on the OSA Framework Initial interface. This allows the client to specify the 
type of authentication process. This authentication process may be specific to the provider, or the implementation 
technology used. The initiateAuthentication method can be used to specify the specific process, (e.g. CORBA security). 
OSA defines a generic authentication interface (API Level Authentication), which can be used to perform the 
authentication process. The initiateAuthentication method allows the client to pass a reference to its own authentication 
interface to the Framework, and receive a reference to the authentication interface preferred by the client, in return. In 
this case the API Level Authentication interface. 

2) The client invokes the selectEncryptionMethod on the Framework's API Level Authentication interface. This 
includes the encryption capabiUties of the cUent. The framework then chooses an encryption method based on the 
encryption capabilities of the client and the Framework. If the client is capable of handling more than one encryption 
method, then the Framework chooses one option, defined in the prescribedMethod parameter. In some instances, the 
encryption capability of the client may not fulfil the demands of the Framework, in which case, the authentication will 
fail. 

3) The application and Framework interact to authenticate each other. For an authentication method of 
P_OSA_AUTHENTICATION, this procedure consists of a number of challenge/ response exchanges. This 
authentication protocol is performed using the authenticate method on the API Level Authentication interface. 
P_OSA_AUTHENTICATION is based on CHAP, which is primarily a one-way protocol. Mutual authentication is 
achieved by the framework invoking the authenticate method on the client's APILevelAuthentication interface. 

Note that at any point during the access session, either side can request re-authentication. Re-authentication does not 
have to be mutual. 
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: IpClientAPILevelAuthentication 



Client 



: Iplnitial 



Framework 


: IpAPILevelAuthentication 







1: initiateAuthentication{ ) 



4: authenticate( ) 



5: authenticate( ) 



6: authenticationSucceeded( ) 



7: authenticate( ) 



: authentibationSucceeded( ) 



9: requestAccess( ) 



IpClientAccess reference is 
passed to Frameworl<, and 
IpAccess reference is 
returned. 




IpClientA PI Level Au tfie nti cati on 
reference is passed to framework 
and IpAPILevel Autfientication 
reference i s returned. 



2: selectEnctyptionMethod( ) 



Ttiis isan example of the 
sequence of 
authentication 
operations Different 
authentication protocols 
may have different 
" requlrementson the 
order of operations. 



6.2 Class Diagrams 
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<<lntei1ace» 
Iplnitial 

Jrom Framework interfaces) 

Initial eAuthenticationO 



<<lnterface» 
IpClientAccess 

(from Client interfaces) 

^■^erminateAccessQ 



«uses» 



<<lntei1ace» 
IpAccess 

(from Frame worl< interfaces) 



♦obtain InterfaceO 
^♦obtainlntei1aceWitliCallbacl<() 
l^endAccessO 
l^listlnterfacesO 
I%eleaselnterface() 



«lntei1ace>> 
IpClientAPILevelAutlientication 

(from CI lent 1 nterfaces) 



fcJ^autlienticateO 

B^abortAutlientication() 

^autlienticationSucceededO 

A 



«uses>> 



«lntei1ace>> 
IpAP ILevel Autlientication 

(from Framework interfaces) 



HselectEncryptionMetliodO 
■autlienticateO 

^abortAutlienticationO 
i^autlienticationSucceededO 



«lntei1ace>> 
IpAutlientication 

(from Framework interfaces) 

^requestAccessO 



Figure: Trust and Security IVIanagement Pacl(age Overview 

6.3 Interface Classes 

6.3.1 Trust and Security Management Interface Classes 

The Trust and Security Management Interfaces provide: 

the first point of contact for a cHent to access a Framework provider; 

the authentication methods for the client and Framework provider to perform an authentication protocol; 

the client with the ability to select a service capability feature to make use of; 

the client with a portal to access other Framework interfaces. 

The process by which the client accesses the Framework provider has been separated into 3 stages, each supported by a 
different Framework interface: 

1) Initial Contact with the Framework; 

2) Authentication to the Framework; 

3) Access to Framework and Service Capability Features. 
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6.3.1.1 Interface Class IpClientAPILevelAuthentication 

Inherits from: Iplnterface. 

If the IpClientAPILevelAuthentication interface is implemented by a client, authenticate(), abortAuthentication() and 
authenticationSucceededO methods shall be implemented. 

«lnterface» 
IpClientAPILevelAuthentication 



authenticate (challenge : in TpOctetSet) : TpOctetSet 
abortAuthentication () : void 
authenticationSucceeded () : void 



Method 

authenticate () 

This method is used by the framework to authenticate the client. The challenge will be encrypted using the mechanism 
prescribed by selectEncryptionMethod. The client must respond with the correct responses to the challenges presented 
by the framework. The number of exchanges is dependent on the policies of each side. The whole authentication 
process is deemed successful when the authenticationSucceeded method is invoked. The invocation of this method may 
be interleaved with authenticate() calls by the client on the IpAPILevel Authentication interface. 

Returns <response> : This is the response of the client application to the challenge of the framework in the current 
sequence. The response will be based on the challenge data, decrypted with the mechanism prescribed by 
selectEncryptionMethodO . 

Parameters 

challenge : in TpOctetSet 

The challenge presented by the framework to be responded to by the client. The challenge mechanism used will be in 
accordance with the IETF PPP Authentication Protocols - Challenge Handshake Authentication Protocol [RFC 1994, 
Augustl996]. The challenge will be encrypted with the mechanism prescribed by selectEncryptionMethodO. 

Returns 
TpOctetSet 

Method 

abortAuthentication ( ) 

The framework uses this method to abort the authentication process. This method is invoked if the framework wishes to 
abort the authentication process, (unless the client responded incorrectly to a challenge in which case no further 
communication with the client should occur.) If this method has been invoked, calls to the requestAccess operation on 
IpAPILevel Authentication will return an error code (P_ACCESS_DENIED), until the client has been properly 
authenticated. 

Parameters 

No Parameters were identified for this method 
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Method 

authenticationSucceeded ( ) 

The Framework uses this method to inform the client of the success of the authentication attempt. 
Parameters 

No Parameters were identified for this method 



6.3.1 .2 Interface Class IpClientAccess 

Inherits from: Iplnterface. 

IpChentAccess interface is offered by the chent to the framework to allow it to initiate interactions during the access 
session. This interface and the terminateAccess() method shall be implemented by a client. 

«lnterface» 
IpClientAccess 



terminateAccess (terminationlext : in TpString, signingAlgorithm : in TpSigningAlgorithm, digitalSignature : 
in TpOctetSet) : void 



Method 

terminateAccess () 

The terminateAccess operation is used by the framework to end the client's access session. 

After terminateAccessO is invoked, the client will no longer be authenticated with the framework. The client will not be 
able to use the references to any of the framework interfaces gained during the access session. Any calls to these 
interfaces will fail. If at any point the framework's level of confidence in the identity of the client becomes too low, 
perhaps due to re-authentication failing, the framework should terminate all outstanding service agreements for that 
client, and should take steps to terminate the client's access session WITHOUT invoking terminateAccessO on the 
chent. This follows a generally accepted security model where the framework has decided that it can no longer trust the 
chent and will therefore sever ALL contact with it. 

Parameters 

terminationText : in TpString 

This is the termination text describes the reason for the termination of the access session. 
signingAlgorithm : in TpSigningAlgorithm 

This is the algorithm used to compute the digital signature. If the signingAlgorithm is invalid, or unknown to the client, 
the P_INVALID_SIGNING_ALGORITHM exception will be thrown. 

digitalSignature : in TpOctetSet 

This is a signed version of a hash of the termination text. If no signing algorithm is used, the digitalSignature is the octet 
sequence of the termination text itself The framework uses this to confirm its identity to the client. The client can 
check that the terminationText has been signed by the framework. If a match is made, the access session is terminated, 
otherwise the P_INVALID_SIGNATURE exception will be thrown. 
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Raises 

TpCommonExceptions, P_INVALID_SIGNING_ALGORITHM, P_INVALID_SIGNATURE 

6.3.1 .3 Interface Class Iplnitial 

Inherits from: Iplnterface. 

The Initial Framework interface is used by the client to initiate the mutual authentication with the Framework. This 
interface and the initiateAuthentication() method shall be implemented by a Framework. 

«lnterface» 
Iplnitial 



initiateAuthentication (clientDomain : in TpAuthDomain, authlype : in TpAuthType) : TpAuthDomain 



Method 

initiateAuthentication () 

This method is invoked by the client to start the process of mutual authentication with the framework, and request the 
use of a specific authentication method. 

Returns <fwDomain> : This provides the client with a framework identifier, and a reference to call the authentication 
interface of the framework. 

structure TpAuthDomain { 

domainID: TpDomainID; 

authlnterface: IpInterfaceRef; 

}; 

The domainID parameter is an identifier for the framework (i.e. TpFwID). It is used to identify the 
framework to the client. 

The authlnterface parameter is a reference to the authentication interface of the framework. The type of this 
interface is defined by the authType parameter. The client uses this interface to authenticate with the framework. 

Parameters 

clientDomain : in TpAuthDomain 

This identifies the client domain to the framework, and provides a reference to the domain's authentication interface. 

structure TpAuthDomain { 

domainID: TpDomainID; 
authlnterface: IpInterfaceRef; 

}; 

The domainID parameter is an identifier either for a client application (i.e. TpClientAppID) or for an enterprise 
operator (i.e. TpEntOpID), or for an instance of a service for which a client application has signed a service agreement 
(i.e. TpServicelnstancelD), or for a service supplier (i.e. TpServiceSupplierlD). It is used to identify the client domain 
to the framework, (see authenticate() on IpAPILevelAuthentication). If the framework does not recognise the 
domainID, the framework returns an eiTor code (P_INVALID_DOMAIN_ID). 

The authlnterface parameter is a reference to call the authentication interface of the client. The type of this interface 
is defined by the authType parameter. If the interface reference is not of the correct type, the framework returns an error 
code (P_INVALID_INTERFACE_TYPE). 
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authType : in TpAuthType 

This identifies the type of authentication mechanism requested by the client. It provides operators and clients with the 
opportunity to use an alternative to the API level Authentication interface, e.g. an implementation specific 
authentication mechanism like CORBA Security, using the IpAuthentication interface, or Operator specific 
Authentication interfaces. OSA API level Authentication is the default authentication mechanism 
(P_OSA_AUTHENTICATION). If P_OS A_AUTHENTICATION is selected, then the clientDomain and fwDomain 
authlnterface parameters are references to interfaces of type Ip(Client)APILevelAuthentication. If 
P_AUTHENTICATION is selected, the fwDomain authlnterface parameter references to interfaces of type 
IpAuthentication which is used when an underlying distribution technology authentication mechanism is used. 

Returns 

TpAuthDomain 

Raises 

TpCommonExceptions, P_INVALID_DOMAIN_ID, P_INVALID_INTERFACE_TYPE , 
P_INVAL ID_AUTH_TYPE 



6.3.1 .4 Interface Class IpAuthentication 

Inherits from: Iplnterface. 

The Authentication Framework interface is used by client to request access to other interfaces supported by the 
Framework. The mutual authentication process should in this case be done with some underlying distribution 
technology authentication mechanism, e.g. CORBA Security. 

One of IpAuthentication or IpAPILevel Authentication interfaces shall be implemented by a Framework. The 
requestAccessO method shall be implemented in each. 

«lnterface» 
IpAuthentication 



requestAccess (accessType : in TpAccessType, clientAccesslnterface : in IplnterfaceRef) : IplnterfaceRef 



Method 

requestAccess () 

Once client and framework are authenticated, the client invokes the requestAccess operation on the IpAuthentication or 
IpAPILevel Authentication interface. This allows the client to request the type of access they require. If they request 
P_OSA_ACCESS, then a reference to the IpAccess interface is returned. (Operators can define their own access 
interfaces to satisfy client requirements for different types of access.) 

If this method is called before the client and framework have successfully completed the authentication process, then 
the request fails, and an error code (P_ACCESS_DENIED) is returned. 

Returns <fwAccessInterface> : This provides the reference for the client to call the access interface of the framework. 
Parameters 

accessType : in TpAccessType 

This identifies the type of access interface requested by the client. If the framework does not provide the type of access 
identified by accessType, then an error code (P_INVALID_ACCESS_TYPE) is returned. 
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clientAccessInterf ace : in Iplnterf aceRef 

This provides the reference for the framework to call the access interface of the client. If the interface reference is not 
of the correct type, the framework returns an error code (P_INVALID_INTERFACE_TYPE). 

Returns 

Iplnterf aceRef 

Raises 

TpCommonExceptions, P_ACCESS_DENIED, P_INVALID_ACCESS_TYPE, 
P_INVALID_INTERFACE_TYPE 



6.3.1 .5 Interface Class IpAPILevelAuthentication 

Inherits from: IpAuthentication. 

The API Level Authentication Framework interface is used by client to perform its part of the mutual authentication 
process with the Framework necessary to be allowed to use any of the other interfaces supported by the Framework. 

If the IpAPILevelAuthentication interface is implemented by a Framework, the selectEncryptionMethod(), 
authenticateO, abortAuthentication() and authenticationSucceeded() methods shall be implemented. 
IpAPILevelAuthentication inherits the requirements of IpAuthentication, therefore requestAccess() shall be 
implemented. 

«lnterface» 
IpAPILevelAuthentication 



selectEncryptionMethod (encryptionCaps : in TpEncryptionCapabilityList) : TpEncryptionCapability 
authenticate (challenge : in TpOctetSet) : TpOctetSet 
abortAuthentication () : void 
authenticationSucceeded () : void 



Method 

selectEncryptionMethod ( ) 

The client uses this method to initiate the authentication process. The framework returns its preferred mechanism. This 
should be within capability of the client. If a mechanism that is acceptable to the framework within the capability of the 
client cannot be found, the framework throws the P_NO_ACCEPTABLE_ENCRYPTION_CAP ABILITY exception. 
Once the framework has returned its preferred mechanism, it will wait for a predefined unit of time before invoking the 
client's authenticate() method (the wait is to ensure that the client can initialise any resources necessary to use the 
prescribed encryption method). 

Returns <prescribedMethod> : This is returned by the framework to indicate the mechanism preferred by the framework 
for the encryption process. If the value of the prescribedMethod returned by the framework is not understood by the 
client, it is considered a catastrophic error and the client must abort. 

Parameters 

encryptionCaps : in TpEncryptionCapabilityList 

This is the means by which the encryption mechanisms supported by the client are conveyed to the framework. 
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Returns 

TpEncryp-t ionCapabil ity 

Raises 

TpCommonExcept ions , P_ACCESS_DENIED , 
P_NO_ACCEPTABLE_ENCRYPTION_CAPABILITY 



Method 

authenticate () 

This method is used by the cUent to authenticate the framework. The challenge will be encrypted using the mechanism 
prescribed by selectEncryptionMethod. The framework must respond with the correct responses to the challenges 
presented by the chent. The domainID received in the initiateAuthentication() can be used by the framework to 
reference the correct public key for the cUent (the key management system is currently outside of the scope of the OSA 
APIs). The number of exchanges is dependent on the policies of each side. The whole authentication process is deemed 
successful when the authenticationSucceeded method is invoked. The invocation of this method may be interleaved 
with authenticateO calls by the framework on the client's APILevelAuthentication interface. 

Returns <response> : This is the response of the framework to the challenge of the cUent in the current sequence. The 
response will be based on the challenge data, decrypted with the mechanism prescribed by selectEncryptionMethod(). 



Parameters 

challenge : in TpOctetSet 

The challenge presented by the client to be responded to by the framework. The challenge mechanism used will be in 
accordance with the IETF PPP Authentication Protocols - Challenge Handshake Authentication Protocol [RFC 1994, 
Augustl996]. The challenge will be encrypted with the mechanism prescribed by selectEncryptionMethod(). 



Returns 
TpOctetSet 

Raises 

TpCommonExceptions , P_ACCESS_DENIED 



Method 

abortAuthentication ( ) 

The client uses this method to abort the authentication process. This method is invoked if the client no longer wishes to 
continue the authentication process, (unless the chent responded incorrectly to a challenge in which case no further 
communication with the client should occur.) If this method has been invoked, calls to the requestAccess operation on 
IpAPILevelAuthentication will return an error code (P_ACCESS_DENIED), until the client has been properly 
authenticated. 



Parameters 

No Parameters were identified for this method 
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Raises 

TpCommonExceptions , P_ACCESS_DENIED 

Method 

authenticationSucceeded ( ) 

The client uses this method to inform the framework of the success of the authentication attempt. 
Parameters 

No Parameters were identified for this method 
Raises 

TpCommonExceptions , P_ACCESS_DENIED 



6.3.1 .6 Interface Class IpAccess 

Inherits from: Iplnterface. 

This interface shall be implemented by a Framework. As a minimum requirement the obtainInterface(), 
obtainlnterfaceWithCallbackO and endAccess() methods shall be implemented. 

«lnterface» 
IpAccess 



obtainlnterface (interfaceName : in TplnterfaceName) : IplnterfaceRef 

obtainlnterfaceWithCallback (interfaceName : in TplnterfaceName, clientlnterface : in IplnterfaceRef) : 
IplnterfaceRef 

endAccess (endAccessProperties : in TpEndAccessProperties) : void 

listlnterfaces () : TplnterfaceNameList 

releaselnterface (interfaceName : in TplnterfaceName) : void 



Method 

obtainlnterface ( ) 

This method is used to obtain other framework interfaces. The client uses this method to obtain interface references to 
other framework interfaces. (The obtainlnterfaceWithCallback method should be used if the client is required to supply 
a callback interface to the framework.) 

Returns <fwlnterface> : This is the reference to the interface requested. 
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Parameters 

interfaceName : in Tplnterf aceName 

The name of the framework interface to which a reference to the interface is requested. If the interfaceName is invalid, 
the framework returns an error code (P_INVALID_INTERFACE_NAME). 

Returns 

IpInterfaceRef 

Raises 

TpCommonExceptions, P_ACCESS_DENIED, P_INVALID_INTERFACE_NAME 



Method 

obtainlnterf aceWithCallback () 

This method is used to obtain other framework interfaces. The client uses this method to obtain interface references to 
other framework interfaces, when it is required to supply a callback interface to the framework. (The obtainlnterface 
method should be used when no callback interface needs to be supplied.) 

Returns <fwlnterface> : This is the reference to the interface requested. 
Parameters 

interfaceName : in Tplnterf aceName 

The name of the framework interface to which a reference to the interface is requested. If the interfaceName is invalid, 
the framework returns an error code (P_INVALID_INTERFACE_NAME). 

clientlnterf ace : in Iplnterf aceRef 

This is the reference to the client interface, which is used for callbacks. If a client interface is not needed, then this 
method should not be used. (The obtainlnterface method should be used when no callback interface needs to be 
supplied.) If the interface reference is not of the correct type, the framework returns an error code 
(P_INVALID_INTERFACE_TYPE). 

Returns 

Iplnterf aceRef 

Raises 

TpCommonExceptions, P_ACCESS_DENIED, P_INVALID_INTERFACE_NAME , 
P_INVALID_INTERFACE_TYPE 



Method 

endAccess () 

The endAccess operation is used by the client to request that its access session with the framework is ended. After it is 
invoked, the chent will no longer be authenticated with the framework. The client will not be able to use the references 
to any of the framework interfaces gained during the access session. Any calls to these interfaces will fail. 
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Parameters 

endAccessProper'ties : in TpEndAccessProperties 

This is a list of properties that can be used to tell the framework the actions to perform when ending the access session 
(e.g. existing service sessions may be stopped, or left running). If a property is not recognised by the framework, an 
error code (P_INVALID_PROPERTY) is returned. 

Raises 

TpCommonExceptions, P_ACCESS_DENIED, P_INVALID_PROPERTY 

Method 

list Interfaces () 

The client uses this method to obtain the names of all interfaces supported by the framework. It can then obtain the 
interfaces it wishes to use using either obtainInterface() or obtainInterfaceWithCallback(). 

Returns <frameworkInterfaces> : The frameworklnterfaces parameter contains a list of interfaces that the framework 
makes available. 

Parameters 

No Parameters were identified for this method 
Returns 

TpInterfaceNameLis't 

Raises 

TpCommonExceptions , P_ACCESS_DENIED 

Method 

releaselnterf ace () 

The client uses this method to release a framework interface that was obtained during this access session. 
Parameters 

interfaceName : in Tplnterf aceName 

This is the name of the framework interface which is being released. If the interfaceName is invalid, the framework 
throws the P_INVALID_INTERFACE_NAME exception. If the interface has not been given to the client during this 
access session, then the P_TASK_REFUSED exception will be thrown. 

Raises 

TpCommonExceptions, P_ACCESS_DENIED, P_INVALID_INTERFACE_NAME 

6.4 State Transition Diagrams 

This clause contains the State Transition Diagrams for the objects that implement the Framework interfaces on the 
gateway side. The State Transition Diagrams show the behaviour of these objects. For each state the methods that can 
be invoked by the client are shown. Methods not shown for a specific state are not relevant for that state and will return 
an exception. Apart from the methods that can be invoked by the client also events internal to the gateway or related to 
network events are shown together with the resulting event or action performed by the gateway. These internal events 
are shown between quotation marks. 
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6.4.1 Trust and Security Management State Transition Diagrams 
6.4.1 .1 State Transition Diagrams for Iplnitial 



initiateAuthentication / return new IpAuthenti cation 



Active 



Figure : State Transition Diagram for Iplnitial 



6.4.1 .2 State Transition Diagrams for IpAPILevelAuthentication 



Iplnitial. initiateAuthentication 



requestAccess 
"P_ACCESS_DENIE[X^^_I 



Idle 



"no method found" 
»P_N0_4CCEPTABLE_ENCRYPTI0N_CAPABILITY 



requestAccess 
"P_ACCESS_DENIED' 



selectEnc ryptionMethod 



Selecting 
Method 



f All States 



'found method" / return presDribedMethod "client. authenticate 



authenticate/ "Buffer request' 
requestAccess »P_ACCESS_DENIE 



authenticate result( VALID )[ Auth 
Incomplete ] tlient. authenticate 



"re-authentlcate' 
Client. authenticat 



result( INVALID ) 



Authenticating 
Client 



authenticate result( VALID )[ AuthComplete ] / 
"Process authenticate requests" "client. authentications ucceeded 



requestAccess / new IpAccess 



Client 
Authenticated 
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Figure : State Transition Diagram for IpAPILevelAutlientication 



6.4.1.2.1 Idle State 



When the chent has invoked the Iplnitial initiateAuthentication method, an object implementing the 
IpAPILevelAuthentication interface is created. The client now has to provide its encryption capabilities by invoking 
selectEncryptionMethod. 



6.4.1 .2.2 Selecting Method State 

In this state the Framework selects the preferred encryption mechanism within the capability of the client. It is a policy 
of the framework (perhaps agreed off-line with the enterprise operator) whether the client has to be authenticated or not. 
In case no mechanism can be found the P_NO_ACCEPTABLE_ENCRYPTION_CAP ABILITY exception is thrown 
and the Authentication object moves back to the IDLE state The client can now revisit its list of supported capabilities 
to identify whether it is complete. If it has no more encryption capabilities to use, then it must invoke 
abortAuthentication. 



6.4.1 .2.3 Authenticating Client State 

When entering this state, the Framework requests the client to authenticate itself by invoking the Authenticate method 
on the cUent. In case the chent requests the Framework to authenticate itself by invoking Authenticate on the 
IpAPILevelAuthentication interface, the Framework will either buffer the requests and respond when the client has 
been authenticated, or respond immediately, depending on policy. When the Framework has processed the response 
from the Authenticate request on the client, the response is analysed. If the response is valid but the authentication 
process is not yet complete, then another Authenticate request is sent to the client. If the response is vahd and the 
authentication process has been completed, then a transition to the state ClientAuthenticated is made, the client is 
informed of its success by invoking authenticationSucceeded, then the framework begins to process any buffered 
authenticate requests. In case the response is not valid, the Authentication object is destroyed. This imphes that the 
chent has to re-initiate the authentication by calUng once more the initiateAuthentication method on the Iplnitial 
interface. 



6.4.1 .2.4 Client Authenticated State 

In this state the chent is considered authenticated and is now allowed to request access to the IpAccess interface. In case 
the client requests the Framework to authenticate itself by invoking Authenticate on the IpAPILevelAuthentication 
interface, the Framework provides the correct response to the challenge. If the framework decides to re-authenticate the 
client, then the authenticate request is sent to the client and a transition back to the AuthenticatingClient state occurs. 



6.4.1 .3 State Transition Diagrams for IpAccess 
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Iplnitial.requestAccess 



obtainlnterfece/ return requested FW interfece 

obtainlnterfaceWithCallback / return requested FW interface 




Active 



network bperator initiated endAccess / destroy all interface objects used by the client 
endAccess / destroy all interface objects used by the client 



Figure : State Transition Diagram for IpAccess 



6.4.1.3.1 Active State 



When the client requests access to the Framework on the Iplnitial interface, an object implementing the IpAccess 
interface is created. The client can now request other Framework interfaces, including Service Discovery. When the 
cUent is no longer interested in using the interfaces it calls the endAccess method. This results in the destruction of all 
interface objects used by the client. In case the network operator decides that the client has no longer access to the 
interfaces the same will happen. 



7 Framework-to-Application API 

7.1 Sequence Diagrams 

7.1 .1 Event Notification Sequence Diagrams 



7.1.1.1 Enable Event Notification 
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AppLoqic 




: IpAppEventNotification 




: IpAccess 




: IpEventNotification 




1 : newQ 

^ 

rJ 2: obtainlnterfac3WithCallback( ) 







3: new() 



4: createNotification( ) 



if- 



5: reportNotification( ) 



1: This message is used to create an object implementing the IpAppEventNotification interface. 

2: This message is used to receive a reference to the object implementing the IpEventNotification interface and set the 
callback interface for the framework. 

3: If there is currently no object implementing the IpEventNotification interface, then one is created using this 
message. 

4: createNotification(eventCriteria : in TpFwEventCriteria) : TpAssignmentID 

This message is used to enable the notification mechanism so that subsequent framework events can be sent to the 
application. The framework event the application requests to be informed of is the availability of new SCFs. 

Newly installed SCFs become available after the invocation of registerService and announceServiceAvailability on the 
Framework. The application uses the input parameter eventCriteria to specify the SCFs of whose availability it wants to 
be notified: those specified in ServiceTypeNameList. 

The result of this invocation has many similarities with the result of invoking listServiceTypes: in both cases the 
application is informed of the availability of a list of SCFs. The differences are: 

in the case of invoking hstServiceTypes, the application has to take the initiative, but it is informed of ALL SCFs 
available 

in the case of using the event notification mechanism, the application needs not take the initiative to ask about the 
availability of SCFs, but it is only informed of the ones that are newly available. 

Alternatively, or additionally, the application can request to be informed of SCFs becoming unavailable. 
5: The application is notified of the availability of new SCFs of the requested type(s). 



ETSI 



3GPP TS 29.198-03 version 4.9.0 Release 4 



34 



ETSI TS 129 198-3 V4.9.0 (2004-06) 



7.1.2 



Integrity Management Sequence Diagrams 



7.1 .2.1 Load Management: Suspend/resume notification from application 

This sequence diagram shows the scenario of suspending or resuming notifications from the application based on the 
evaluation of the load balancing policy as a result of the detection of a change in load level of the framework. 



IpAppLoadManaqer 



IpLoad Manager 



1 : load change detection and policy evaluation 



2: suspendNotification( 



This is 

implementation 
detail 



Load balancing service 
makes a decision based 
on pre-defined policy 



Application provides 
initial load report on 
notification 
resumption 



1^ 



3: load change detection and policy evaluation 



4; resumeNotification( ) 



5: report Load( 



7.1 .2.2 Load Management: Framework queries load statistics 

This sequence diagram shows how the framework requests load statistics for an application. 
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IpLoadManaqer 



: IpAppLoadManaqer 



1 : queryAppLoadReq( ) 



2: get load information 



3: queryAppLoadRes( ) 



This is the 

implementation 

detail 



7.1 .2.3 Load Management: Framework callback registration and Application load 
control 



This sequence diagram shows how the framework registers itself and the application invokes load management function 
to inform the framework of application load. 
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IpAppLoadManaqer 



1: createLoad Level Notification! ] 



2: reportLoad{ ) 



3: ioadichange detection 



This is Application 
implementation detail. 
The Application may take 
appropriate load control 
action 



4: reportLoad{ ) 



This is Application 
implementation detail. 
The Application may take 
appropriate load control 
action. 



5: load change detection 

'< ^ 



6: reportLoad( ) 



IpLoadManaqer 



Application reports its initial 
load condition on notification 
- creation 



Application detects a load 
condition change and 
reports to framework. The 
framework may take 
appropriate load control 
action - implementation 
detail. 



7: destroyLoadLevelNotification( ; 



7.1 .2.4 Load Management: Application reports current load condition 

This sequence diagram shows how an application reports its load condition to the framework load manager. 



IpAppLoadManaqer 



bLoadManaqer 



1 : reportLoad( 



2: Evaluate policy 



This is the implementationl 
detail 
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7.1 .2.5 Load Management: Application queries load statistics 

This sequence diagram shows how an application requests load statistics for the framework. 



IpAppLoadManager 



: IpLoadManager 



1 : queryLoadReq( ) 



> 

2: ge 



3: queryLoadRes( ) 



load information 



This is tine 

implementation 

detail 



7.1 .2.6 Load Management: Application callback registration and load control 

This sequence diagram shows how an application registers itself and the framework invokes load management function 
based on policy. 
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: IpAppLoadManaqer 



IpLoadManaqer 



1 : createLoadLevelNotificationf 



2: loadLevelNotifcationC 



1^ 



Framework reports its initial 
load condition on notification 
creation 



3: load change detection & policy evaluation 



4: loadLevelNoti1ication( ) 



Frameworl< detects a load 

condition cliange 

and notifies the application. 

The application may take 

appropriate load control 

action - implementation 

detail. 



This is Framework implementation 
detail. The Framework maytake 
appropriate load control action. 
5: load change d^teetion-&-policy€valtiatiofi 



6: loadLevelNoti1ication( 



'-i<r 



7: destroyLoadLevelNotification{ ) 



This is Framework implementation ^ 
detail. The Framework may take 
appropriate load control action. 



7.1 .2.7 Heartbeat Management: Start/perform/end heartbeat supervision of the 
application 

In this sequence diagram, the framework has decided that it wishes to monitor the application, and has therefore 
requested the application to commence sending its heartbeat. The application responds by sending its heartbeat at the 
specified interval. The framework then decides that it is satisfied with the application's health and disables the heartbeat 
mechanism. If the heartbeat was not received from the application within the specified interval, the framework can 
decide that the application has failed the heartbeat and can then perform some recovery action. 
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Framework 



: IpHeartBeat 



1: enableAppheartBeat( ) 



: IpAppHeartBeatMqmt 



^1 



1^ 



2: pulse( ) 



3: pulse( ) 



4: disableAppHeartBeat( 



At a certain point of 
time tlie framework 
decides to stop 
lieartbeat supervision 



7.1 .2.8 Fault Management: Framework detects a Service failure 

The framework has detected that a service instance has failed (probably by the use of the heartbeat mechanism). The 
framework updates its own records and informs the client application using the service instance to stop. 
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Client Application : IpAppFaultManager 



Framework : IpFault Manager 



The framework should detect if 
a service instance fails, for 
example via an unretumed 
heartbeat. The framework 
should inform the application 
that is using that service 
instance. 



1 : svcUnavailablelnd( ) 



The application must 
cease the use of this 
service instance. 



1: The framework informs the client appUcation that is using the service instance that the service is unavailable. The 
client application is then expected to abandon use of this service instance and access a different service instance via the 
usual means (e.g. discovery, selectService etc.). The client application should not need to re-authenticate in order to 
discover and use an alternative service instance. The framework will also need to make the relevant updates to its 
internal records to make sure the service instance is removed from service and no client applications are still recorded as 
using it. 



7.1 .2.9 Fault Management: Application requests a Framework activity test 
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Client Application : IpAppFaultManaqer 



Client application asks framework to 
carry out an activity test. The 
framework is denoted as the target 
by an empty string value for s\jc\6. 



Framework : IpFaultManaqer 



1 : activityTestReq( ) 



Framework carries out test and 
returns result to client application. 



2: activityTestRes( ) 





1 : The client application asks the framework to do an activity test. The client identifies that it would like the activity 
test done for the framework, rather then a service, by supplying an empty string value for the svcid parameter. 

2: The framework does the requested activity test and sends the result to the client application. 



7.1 .3 Service Discovery Sequence Diagrams 
7.1.3.1 Service Discovery 

The following figure shows how Applications discover a new Service Capability Feature in the network. Even 
applications that have already used the OSA API of a certain network know that the operator may upgrade it any time; 
this is why they use the Service Discovery interfaces. 

Before the discovery process can start, the Application needs a reference to the Framework's Service Discovery 
interface; this is done via an invocation the method obtainlnterface on the Framework's Access interface. 
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Discovery can be a three-step process. The first two steps have to be performed initially, but can subsequently be 
skipped (if the service type and its properties are already known, the application can invoke discoverService() without 
having to re-invoke the list/discoverServiceType methods): 



Application 



IpAccess 



IpServiceDiscovery 



1: obtain I nterface( ; 



2: listServiceTypes( ) 



3: describeServiceType( [ 



4: discoverSetvice( ) 



^1 



2: Discovery: first step - list service types 

In this first step the application asks the Framework what service types that are available from this network. Service 
types are standardized or non-standardised SCF names, and thus this first step allows the Application to know what 
SCFs are supported by the network. 

The following output is the result of this first discovery step: 
out listTypes 

This is a list of service type names, i.e., a list of strings, each of them the name of a SCF or a SCF specialization (e.g. 
"P_MPCC"). 

3: Discovery: second step - describe service type 

In this second step the apphcation requests what are the properties that describe a certain service type that it is interested 
in, among those listed in the first step. 

The following input is necessary: 

in name 

This is a service type name: a string that contains the name of the SCF whose description the Application is interested in 
(e.g. "P_MPCC") . 

And the output is: 

out serviceTypeDescription 
The description of the specified SCF type. The description provides information about: 

the property names associated with the SCF, 

the corresponding property value types. 
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the corresponding property mode (mandatory or read only) associated with each SCF property, 
the names of the super types of this type, and 
whether the type is currently enabled or disabled. 
4: Discovery: third step - discover service 

In this third step the application requests for a service that matches its needs by tuning the service properties (i.e., 
assigning values for certain properties). 

The Framework then checks whether there is a match, in which case it sends the AppUcation the servicelD that is the 

identifier this network operator has assigned to the SCF version described in terms of those service properties. This is 
the moment where the servicelD identifier is shared with the application that is interested on the corresponding service. 

This is done for either one service or more (the application specifies the maximum number of responses it wishes to 
accept). 

Input parameters are: 
in serviceTypeName 

This is a string that contains the name of the SCF whose description the Apphcation is interested in (e.g. "P_MPCC"). 
in desiredPropertyList 

This is again a list like the one used for service registration, but where the value of the service properties have been fine 
tuned by the Application to (they will be logically interpreted as "minimum", "maximum", etc. by the Framework). 

The following parameter is necessary as input: 

in max 

This parameter states the maximum number of SCFs that are to be returned in the "ServiceList" result. 
And the output is: 
out serviceList 

This is a list of duplets: (servicelD, servicePropertyList). It provides a list of SCFs matching the requirements from the 
AppUcation, and about each: the identifier that has been assigned to it in this network (servicelD), and once again the 
service property hst. 



7.1 .4 Service Agreement Management Sequence Diagrams 
7.1.4.1 Service Selection 

The following figure shows the process of selecting an SCF. 

After discovery the Apphcation gets a list of one or more SCF versions that match its required description. It now needs 
to decide which service it is going to use; it also needs to actually get a way to use it. 

This is achieved by the following two steps: 
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IpAppServiceAqreementManaqement 



Application 



IpServiceAqreementlVlanaqement 



Frameworl< 



1: selects ervice( ] 



i: initiateSignServiceAgreement(l) 

^ 



3: signServiceAgreement( |) 



4: signServ(ceAgreement( 



1: Service Selection: first step - selectService 

In this first step the Application identifies the SCF version it has finally decided to use. This is done by means of the 
servicelD, which is the agreed identifier for SCF versions. The Framework acknowledges this selection by returning to 
the Application a new identifier for the service chosen: a service token, that is a private identifier for this service 
between this Application and this network, and is used for the process of signing the service agreement. 

Input is: 

in servicelD 
This identifies the SCF required. 
And output: 

out serviceToken 

This is a free format text token returned by the framework, which can be signed as part of a service agreement. It 
contains operator specific information relating to the service level agreement. 

2: Service Selection: second step - signServiceAgreement 

In this second step an agreement is signed that allows the Application to use the chosen SCF version. And once this 
contractual details have been agreed, then the Application can be given the means to actually use it. The means are a 
reference to the manager interface of the SCF version (remember that a manager is an entry point to any SCF). By 
calling the createServiceManager operation on the lifecycle manager the Framework retrieves this interface and returns 
it to the Application. The service properties suitable for this application are also fed to the SCF (via the lifecycle 
manager interface) in order for the SCS to instantiate an SCF version that is suitable for this application. 

Input: 

in serviceToken 

This is the identifier that the network and Application have agreed to privately use for a certain version of SCF. 
in agreementText 
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This is the agreement text that is to be signed by the Framework using the private key of the Framework. 

in signingAlgorithm 
This is the algorithm used to compute the digital signature. 
Output: 

out signatureAndServiceMgr 

This is a reference to a structure containing the digital signature of the Framework for the service agreement, and a 
reference to the manager interface of the SCF. 

7.2 Class Diagrams 



«lnterface» 
IpAppEventNot ifi cation 

(from App Interfaces) 




|%eportNotification() 
l^notificationTerminatedO 




«uses» 






«lnterface» 
IpEventNotification 

(from Framework Interfaces) 












' '^createNotificationO 
♦destroyNotificationQ 





Figure: Event Notification Class Diagram 
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«hterfa:e» 
IpAppHeartBeatMgmt 



enableAppHeartBeatO 
disableAppHeartBeatO 
changelntervalO 



«hterface» 
IpHeartBeatMgmt 



enableHeartBeatO 
disableHeartBeatO 
changelntervalO 



«lnterface» 
IpApp Heart Beat 



pulseQ 



«lnterface» 
IpHeartBeat 



0..n 



pulseQ 



«lnterface» 
IpApp Load Manager 



queryAppLoadReqQ 

query LoadResO 

query LoadErrQ 

loadLevelNotificationQ 

resumeNotificationQ 

suspendNotificationO 

«new» createLoadLevelNotificationO 

«new» destroy LoadLevelNotificationQ 



«lnterface» 
IpLoad Manager 

r^ortLoadQ 
query Load Req() 
queryAppLoadResO 
queryAppLoadErrO 
cteateLDadLe\el Notific ationQ 
destroyLoadLe\elNotffication{) 
resumeNotfficationO 
suspsid Not m cation Q 



«lnterface» 
IpAppFaultManager 

actiytyTestResQ 

appActivityTestReqO 

IwFaultReporthdQ 

IwFaultRecoverylndO 

s\cL)navailablelnd(} 

genFaJtStats RecoidRes Q 

fwUnavailablelndO 

actiytyTestErr(} 

genFaJtStats RecotdErr(} 

appUnavailablelndO 

genFaJtStats Record ReqQ 



«lnterface» 
IpFaultManager 

actiytyTestPteqQ 
appActivityTestResO 
sy:;Unavailablelnd() 
genFaJtStats Record ReqQ 
appActivityTestErrQ 
appUnavailablelndO 
genFaJtStats Record Res Q 
genFaJtStats RecordErr() 



«lnterface» 
IpAppOAM 



systemDateTlmeQueryO 



«uses» 



«lnterface» 
IpOAM 



SystemDateTlmeQueryO 



Figure: Integrity l\/lanagement Package Overview 



«lnterface» 
IpServiceDiscovery 

(from Frame\Aork interfaces) 



Pll i s tS ervic eTy pes() 
l^desc ri beServiceTypeQ 
l^discoverServiceO 
l^listSubscribedSerMcesQ 



Figure: Service Discovery Paclcage Overview 
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«lnterface» 
Iplnitial 

(from Framework interfaces) 



■^initiateAuthenticationQ 



«lnterface» 
IpClientAccess 

(from Client interfaces) 



|terminateAccess() 



«uses» 



«lnterface» 
IpAccess 

(from Framework interfaces) 



^obtainlnterfaceO 

^obtainlnterfaceWithCallbackQ 
^endAccessO 
HflistlnterfacesO 

"''►releaselnterfaceO 



«lnterface» 
IpClientAPILevel Authentication 

(from Client interfaces) 

^authenticateQ 

l^abortAuthenticationO 

^authenticationSucceededO 

7N 

«uses» 



«lnterface» 
IpAPILevelAuttienti cation 

(from Framework interfaces) 



%electEncryptionl\/lethod() 
^auttienticateQ 
^abortAuthenticationO 
^authenticationSucceededO 



«lnterface» 
IpAuthentication 

(from Framework interfaces) 



IrequestAccessQ 



Figure: Trust and Security IVIanagement Pacl<age Overview 
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«lnterface» 
IpAppServiceAgreementManagement 

(from App Interfaces) 



l^signServiceAgreementO 
l^erminateServiceAgreementO 

<;<uses» 



«lnterface» 
IpServiceAgreementManagement 

(from Framework Interfaces) 



^signServiceAgreementO 
HherminateServiceAgreementO 

f ^selectServiceO 

I ♦initiateSignServiceAgreementO 



Figure: Service Agreement IVIanagement Paclcage Overview 

7.3 Interface Classes 

7.3.1 Service Discovery Interface Classes 



7.3.1.1 Interface Class IpServiceDlscovery 

Inherits from: Iplnterface. 

The service discovery interface, shown below, consists of four methods. Before a service can be discovered, the 
enterprise operator (or the client applications) must know what "types" of services are supported by the Framework and 
what service "properties" are applicable to each service type. The listServiceType() method returns a list of all "service 
types" that are currently supported by the framework and the "describeServiceTypeO" returns a description of each 
service type. The description of service type includes the "service-specific properties" that are applicable to each service 
type. Then the enterprise operator (or the client applications) can discover a specific set of registered services that both 
belong to a given type and possess the desired "property values", by using the "discoverService() method. Once the 
enterprise operator finds out the desired set of services supported by the framework, it subscribes to (a sub-set of) these 
services using the Subscription Interfaces. The enterprise operator (or the client applications in its domain) can find out 
the set of services available to it (i.e., the service that it can use) by invoking "listSubscribedServicesO". The service 
discovery APIs are invoked by the enterprise operators or client applications. They are described below. 
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This interface shall be implemented by a Framework with as a minimum requirement the listServiceTypes(), 
describeServiceTypeO and discoverService() methods. 

«lnterface» 
IpServiceDiscovery 



listServicelypes () : TpServicelypeNameList 

describeServicelype (name : in TpServicelypeName) : TpServicelypeDescription 

discoverService (serviceTypeName : in TpServicelypeName, desiredPropertyList : in 
TpServicePropertyList, max : in Tplnt32) : TpServiceList 

listSubscribedServices () : TpServiceList 



Method 

listServiceTypes () 

This operation returns the names of all service types that are in the repository. The details of the service types can then 
be obtained using the describeServiceTypeO method. 

Returns <listTypes> : The names of the requested service types. 
Parameters 

No Parameters were identified for this method 
Returns 

TpServiceTypeNameList 

Raises 

TpCommonExceptions , P_ACCESS_DENIED 



Method 

describeServiceType () 

This operation lets the caller obtain the details for a particular service type. 

Returns <serviceTypeDescription> : The description of the specified service type. The description provides information 
about: 

• the service properties associated with this service type: i.e. a list of service property {name, mode and type} tuples, 

• the names of the super types of this service type, and 

• whether the service type is currently available or unavailable. 

Parameters 

name : in TpServiceTypeName 

The name of the service type to be described. 

• If the "name" is malformed, then the P_ILLEGAL_SERVICE_TYPE exception is raised. 

• If the "name" does not exist in the repository, then the P_UNKNOWN_SERVICE_TYPE exception is raised. 
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Returns 

TpServiceTypeDescription 

Raises 

TpCommonExceptions, P_ACCESS_DENIED, P_ILLEGAL_SERVICE_TYPE , 
P_UNKNOWN_SERVICE_TYPE 



Method 

discoverService () 

The discoverService operation is the means by which a client appUcation is able to obtain the service IDs of the services 
that meet its requirements. The client application passes in a list of desired service properties to describe the service it is 
looking for, in the form of attribute/value pairs for the service properties. The chent application also specifies the 
maximum number of matched responses it is wilUng to accept. The framework must not return more matches than the 
specified maximum, but it is up to the discretion of the Framework implementation to choose to return less than the 
specified maximum. The discoverService() operation returns a servicelD/Property pair list for those services that match 
the desired service property list that the cUent appUcation provided. The service properties returned will form a 
complete view of what the client application will be able to do with the service, as per the service level agreement. If 
the framework supports service subscription, the service level agreement will be encapsulated in the subscription 
properties contained in the contract/profile for the client appUcation, which wiU be a restriction of the registered 
properties. 

Returns <serviceList> : This parameter gives a list of matching services. Each service is characterised by its service ID 
and a list of service properties {name and value list} associated with the service. 

Parameters 

serviceTypeName : in TpServiceTypeName 

The "serviceTypeName" parameter conveys the required service type. It is key to the central purpose of "service 
trading". It is the basis for type safe interactions between the service exporters (via registerService) and service 
importers (via discoverService). By stating a service type, the importer implies the service type and a domain of 
discourse for talking about properties of service. 

• If the string representation of the "type" does not obey the rules for service type identifiers, then the 
P_ILLEGAL_SERVICE_TYPE exception is raised. 

• If the "type" is correct syntactically but is not recognised as a service type within the Framework, then the 
P_UNKNOWN_SERVlCE_TYPE exception is raised. 

The framework may return a service of a subtype of the "type" requested. A service sub-type can be described by the 
properties of its supertypes. 

desiredPropertyList : in TpServicePropertyList 

The "desiredPropertyList" parameter is a list of service properties {name and value list} that the discovered set of 
services should satisfy. These properties deal with the non-functional and non-computational aspects of the desired 
service. The property values in the desired property list must be logically interpreted as "minimum", "maximum", etc. 
by the framework (due to the absence of a Boolean constraint expression for the specification of the service criterion). It 
is suggested that, at the time of service registration, each property value be specified as an appropriate range of values, 
so that desired property values can specify an "enclosing" range of values to help in the selection of desired services. 

max : in Tpln't32 

The "max" parameter states the maximum number of services that are to be returned in the "serviceList" result. 
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Returns 

TpServiceList 

Raises 

TpCommonExceptions, P_ACCESS_DENIED, P_ILLEGAL_SERVICE_TYPE , 
P_UNKNOWN_SERVICE_TYPE , P_INVALID_PROPERTY 



Method 

listSubscribedServices () 

Returns a list of services so far subscribed by the enterprise operator. The enterprise operator (or the chent applications 
in the enterprise domain) can obtain a list of subscribed services that they are allowed to access. 

Returns <serviceList> : The "serviceList" parameter returns a list of subscribed services. Each service is characterised 
by its service ID and a list of service properties {name and value list} associated with the service. 

Parameters 

No Parameters were identified for this method 
Returns 

TpServiceList 

Raises 

TpCommonExceptions , P_ACCESS_DENIED 

7.3.2 Service Agreement Management Interface Classes 
7.3.2.1 Interface Class IpAppServiceAgreementManagement 

Inherits from; Iplnterface. 

This interface and the signServiceAgreement() and terminateServiceAgreement() methods shall be implemented by an 
application. 

«lnterface» 
IpAppServiceAgreementManagement 



signServiceAgreement (serviceToken : in TpServiceToken, agreementText : in TpString, signingAlgoritlnm : 
in TpSigningAlgoritlnm) : TpOctetSet 

terminateServiceAgreement (serviceToken : in TpServiceToken, terminationText : in TpString, 
digitalSignature : in TpOctetSet) : void 



ETSI 



3GPP TS 29.198-03 version 4.9.0 Release 4 



52 



ETSI TS 129 198-3 V4.9.0 (2004-06) 



Method 

signServiceAgreement () 

Upon receipt of the initiateSignServiceAgrement() method from the cHent appHcation, this method is used by the 
framework to request that the cHent application sign an agreement on the service. The framework provides the service 
agreement text for the chent appUcation to sign. The service manager returned will be configured as per the service 
level agreement. If the framework uses service subscription, the service level agreement will be encapsulated in the 
subscription properties contained in the contract/profile for the client application, which will be a restriction of the 
registered properties. If the client application agrees, it signs the service agreement, returning its digital signature to the 
framework. 

Returns <digitalSignature> : The digitalSignature is the signed version of a hash of the service token and agreement text 
given by the framework. If no signing algorithm is used, the digitalSignature is the octet sequence of the service token 
and the agreement text. If the signature is incorrect the serviceToken will be expired immediately. 

Parameters 

serviceToken : in TpServiceToken 

This is the token returned by the framework in a call to the selectService() method. This token is used to identify the 
service instance to which this service agreement corresponds. (If the client application selects many services, it can 
determine which selected service corresponds to the service agreement by matching the service token.) If the 
serviceToken is invalid, or not known by the client application, then the P_INVALID_SERVICE_TOKEN exception is 
thrown. 

agreement Text : in TpString 

This is the agreement text that is to be signed by the cUent application using the private key of the cUent appUcation. If 
the agreementText is invalid, then the P_INVALID_AGREEMENT_TEXT exception is thrown. 

signingAlgorithm : in TpSigningAlgorithm 

This is the algorithm used to compute the digital signature. If the signingAlgorithm is invalid, or unknown to the client 
application, the P_INVALID_SIGNING_ALGORITHM exception is thrown. 

Returns 
TpOctetSet 

Raises 

TpCommonExceptions, P_INVALID_AGREEMENT_TEXT, P_INVALID_SERVICE_TOKEN, 
P_INVALID_S IGNING_ALGORITHM 



Method 

terminateServiceAgreement ( ) 

This method is used by the framework to terminate an agreement for the service. 
Parameters 

serviceToken : in TpServiceToken 

This is the token passed back from the framework in a previous selectService() method call. This token is used to 
identify the service agreement to be terminated. If the serviceToken is invalid, or unknown to the client application, the 
P_INVALID_SERVICE_TOKEN exception will be throvm. 

terminationText : in TpString 

This is the termination text that describes the reason for the termination of the service agreement. 
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digitalSignature : in TpOctetSet 

This is a signed version of a hash of the service token and the termination text. If no signing algorithm is used, the 
digitalSignature is the octet sequence of the termination text itself The signing algorithm used is the same as the 
signing algorithm given when the service agreement was signed using signServiceAgreement(). The framework uses 
this to confirm its identity to the client application. The client application can check that the terminationText has been 
signed by the framework. If a match is made, the service agreement is terminated, otherwise the 
P_INVALID_SIGNATURE exception will be thrown. 

Raises 

TpCommonExceptions, P_INVALID_SERVICE_TOKEN, P_INVALID_SIGNATURE 

7.3.2.2 Interface Class IpServiceAgreementManagement 

Inherits from: Iplnterface. 

This interface and the signServiceAgreement(), terminateServiceAgreementQ, selectServiceQ and 
initiateSignServiceAgreementO methods shall be implemented by a Framework. 

«lnterface» 
IpServiceAgreementManagement 



signServiceAgreement (serviceToken : in TpServiceToken, agreementlext : in TpString, signingAlgoritlnm : 
in TpSigningAlgoritlnm) : TpSignatureAndServiceMgr 

terminateServiceAgreement (serviceToken : in TpServiceToken, terminationText : in TpString, 
digitalSignature : in TpOctetSet) : void 

selectService (servicelD : in TpServicelD) : TpServiceToken 

InitiateSignServiceAgreement (serviceToken : in TpServiceToken) : void 



Method 

SignServiceAgreement () 

This method is used by the client application to request that the framework sign an agreement on the service, which 
allows the client application to use the service. If the framework agrees, both parties sign the service agreement, and a 
reference to the service manager interface of the service is returned to the client application. The service manager 
returned will be configured as per the service level agreement. If the framework uses service subscription, the service 
level agreement will be encapsulated in the subscription properties contained in the contract/profile for the client 
application, which will be a restriction of the registered properties. If the client application is not allowed to access the 
service, then an error code (P_SERVICE_ACCESS_DENIED) is returned. 

Returns <signatureAndServiceMgr> : This contains the digital signature of the framework for the service agreement, 
and a reference to the service manager interface of the service, 
structure TpSignatureAndServiceMgr { 
digitalSignature: TpOctetSet; 

serviceMgrlnterface: IpServiceRef; 

}; 

The digitalSignature is the signed version of a hash of the service token and agreement text given by the client 
application. If no signing algorithm is used, the digitalSignature is the octet sequence of the service token and the 
agreement text given by the client application. 

The serviceMgrlnterface is a reference to the service manager interface for the selected service. 
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Parameters 

serviceToken : in TpServiceToken 

This is the token returned by the framework in a call to the selectService() method. This token is used to identify the 
service instance requested by the client application. If the serviceToken is invalid, or has expired, an error code 
(P_INVALID_SERVICE_TOKEN) is returned. 

agreementText : in TpString 

This is the agreement text that is to be signed by the framework using the private key of the framework. If the 
agreementText is invalid, then an error code (P_INVALID_AGREEMENT_TEXT) is returned. 

signingAlgorithm : in TpSigningAlgorithm 

This is the algorithm used to compute the digital signature. If the signingAlgorithm is invalid, or unknown to the 
framework, an error code (P_INVALID_SIGNING_ALGORITHM) is returned. 

Returns 

TpSignatureAndServiceMgr 

Raises 

TpCommonExceptions, P_ACCESS_DENIED, P_INVALID_AGREEMENT_TEXT, 
P_INVALID_SERVICE_TOKEN , P_INVALID_SIGNING_ALGORITHM, 
P_SERVICE_ACCESS_DENIED 



Method 

terminateServiceAgreement ( ) 

This method is used by the chent application to terminate an agreement for the service. 
Parameters 

serviceToken : in TpServiceToken 

This is the token passed back from the framework in a previous selectService() method call. This token is used to 
identify the service agreement to be terminated. If the serviceToken is invalid, or has expired, an error code 
(P_INVALID_SERVICE_TOKEN) is returned. 

terminationText : in TpString 

This is the termination text that describes the reason for the termination of the service agreement. 
digitalSignature : in TpOctetSet 

This is a signed version of a hash of the service token and the termination text. If no signing algorithm is used, the 
digitalSignature is the octet sequence of the termination text itself. The signing algorithm used is the same as the 
signing algorithm given when the service agreement was signed using signServiceAgreement().The framework uses this 
to check that the terminationText has been signed by the client application. If a match is made, the service agreement is 
terminated, otherwise an error code (P_INVALID_SIGNATURE) is returned. 

Raises 

TpCommonExceptions, P_ACCESS_DENIED, P_INVALID_SERVICE_TOKEN, 
P_INVALID_S IGNATURE 
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Method 

selectService () 

This method is used by the cHent application to identify the service that the client application wishes to use. If the client 
application is not allowed to access the service, then the P_SERVICE_ACCESS_DENIED exception is thrown. The 
P_SERVICE_ACCESS_DENIED exception is also thrown if the client attempts to select a service for which it has 
already signed a service agreement for, and therefore obtained an instance of. This is because there must be only one 
service instance per client application. 

Returns <serviceToken> : This is a free format text token returned by the framework, which can be signed as part of a 
service agreement. This will contain operator specific information relating to the service level agreement. The 
serviceToken has a limited lifetime. If the lifetime of the serviceToken expires, a method accepting the serviceToken 
will return an error code (P_INVALID_SERVICE_TOKEN). Service Tokens will automatically expire if the client 
application or framework invokes the endAccess method on the other's corresponding access interface. 

Parameters 

servicelD : in TpServicelD 

This identifies the service required. If the servicelD is not recognised by the framework, an error code 
(P_INVALID_SERVICE_ID) is returned. 

Returns 

TpServiceToken 

Raises 

TpCommonExceptions, P_ACCESS_DENIED, P_INVALID_SERVICE_ID , 
P_SERVICE_ACCESS_DENIED 



Method 

InitiateSignServiceAgreement () 

This method is used by the client application to initiate the sign service agreement process. If the client application is 
not allowed to initiate the sign service agreement process, the exception (P_SERVICE_ACCESS_DENIED) is thrown. 

Parameters 

serviceToken : in TpServiceToken 

This is the token returned by the framework in a call to the selectService() method. This token is used to identify the 
service instance requested by the client application. If the serviceToken is invalid, or has expired, the exception 
(P_INVALID_SERVICE_TOKEN) is thrown. 

Raises 

TpCommonExceptions, P_INVALID_SERVICE_TOKEN, P_SERVICE_ACCESS_DENIED 

7.3.3 Integrity Management Interface Classes 
7.3.3.1 interface Class IpAppFaultManager 

Inherits from: Iplnterface. 

This interface is used to inform the application of events that affect the integrity of the Framework, Service or Client 
Application. The Fault Management Framework will invoke methods on the Fault Management Application Interface 
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that is specified when the cHent application obtains the Fauh Management interface: i.e. by use of the 
obtainlnterfaceWithCallback operation on the IpAccess interface. 

«lnterface» 
IpAppFaultManager 



activityTestRes (activityTestID : in TpActivityTestID, activityTestResult : in TpActivityTestRes) : void 
appActivityTestReq (activityTestID : in TpActivityTestID) : void 
fwFaultReportInd (fault : in TplnterfaceFault) : void 
fwFaultRecoveryInd (fault : in TplnterfaceFault) : void 

svcUnavailableInd (servicelD : in TpServicelD, reason : in TpSvcUnavail Reason) : void 
genFaultStatsRecordRes (faultStatistics : in TpFaultStatsRecord, servicelDs : in TpServicelDList) : void 
fwUnavailableInd (reason : in TpFwUnavailReason) : void 
activityTestErr (activityTestID : in TpActivityTestID) : void 

genFaultStatsRecordErr (faultStatisticsError : in TpFaultStatisticsError, servicelDs : in TpServicelDList) : 
void 

appUnavailableInd (servicelD : in TpServicelD) : void 
genFaultStatsRecordReq (timePeriod : in TpTimelnterval) : void 



Method 

activityTestRes () 

The framework uses this method to return the result of a client application-requested activity test. 
Parameters 

activityTestID : in TpActivityTestID 

Used by the client application to correlate this response (when it arrives) with the original request. 

activityTestResult : in TpActivityTestRes 

The result of the activity test. 

Method 

appActivityTestReq ( ) 

The framework invokes this method to test that the client application is operational. On receipt of this request, the 
application must carry out a test on itself, to check that it is operating correctly. The application reports the test result 
by invoking the appActivityTestRes method on the IpFaultManager interface. 

Parameters 

activityTestID : in TpActivityTestID 

The identifier provided by the framework to correlate the response (when it arrives) with this request. 
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Method 

f wFaultReportInd ( ) 

The framework invokes this method to notify the client application of a failure within the framework. The client 
application must not continue to use the framework until it has recovered (as indicated by a fwFaultRecoveryInd). 

Parameters 

fault : in TpInterfaceFault 

Specifies the fault that has been detected by the framework. 

Method 

fwFaultRecoveryInd ( ) 

The framework invokes this method to notify the client application that a previously reported fault has been rectified. 
The application may then resume using the framework. 

Parameters 

fault : in Tplnterf aceFault 

Specifies the fault from which the framework has recovered. 

Method 

svcUnavailableInd ( ) 

The framework invokes this method to inform the client application that it can no longer use its instance of the indicated 

service. On receipt of this request, the client application must act to reset its use of the specified service (using the 
normal mechanisms, such as the discovery and authentication interfaces, to stop use of this service instance and begin 
use of a different service instance). 

Parameters 

service ID : in TpServicelD 

Identifies the affected service. 

reason : in TpSvcUnavailReason 

Identifies the reason why the service is no longer available 

Method 

genFaultStatsRecordRes () 

This method is used by the framework to provide fault statistics to a client application in response to a 
genFaultStatsRecordReq method invocation on the IpFaultManager interface. 

Parameters 

f aultStatistics : in TpFaultStatsRecord 

The fault statistics record. 

servicelDs : in TpServicelDList 

Specifies the framework or services that are included in the general fault statistics record. If the servicelDs parjimeter is 
an empty list, then the fault statistics are for the framework. 
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Method 

f wUnavailableInd ( ) 

The framework invokes this method to inform the client application that it is no longer available. 
Parameters 

reason : in TpFwUnavailReason 

Identifies the reason why the framework is no longer available 

Method 

activityTestErr ( ) 

The framework uses this method to indicate that an error occurred during an apphcation-initiated activity test. 
Parameters 

activityTestID : in TpActivityTestID 

Used by the apphcation to correlate this response (when it arrives) with the original request. 
Method 

genFaultStatsRecordErr 

This method is used by the framework to indicate an error fulfilling the request to provide fault statistics, in response to 
a genFaultStatsRecordReq method invocation on the IpFaultManager interface. 

Parameters 

f aul'tStatisticsError : in TpFaultS'tatis'ticsError 

The fault statistics error. 

servicelDs : in TpServicelDList 

Specifies the framework or services that were included in the general fault statistics record request. If the servicelDs 
parameter is an empty list, then the fault statistics were requested for the framework. 

Method 

appUnavailableInd ( ) 

The framework invokes this method to indicate to the application that the service instance has detected that it is not 
responding. On receipt of this indication, the apphcation must end its current session with the service instance. 

Parameters 

servicelD : in TpServicelD 

Specifies the service for which the indication of unavailability was received. 
Method 

genFaultStatsRecordReq ( ) 

This method is used by the framework to soUcit fault statistics from the client application, for example when the 
framework was asked for these statistics by a service instance by using the genFaultStatsRecordReq operation on the 
IpFwFaultManager interface. On receipt of this request, the client apphcation must produce a fault statistics record, for 
the application during the specified time interval, which is returned to the framework using the genFaultStatsRecordRes 
operation on the IpFaultManager interface. 
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Parameters 

timePeriod : in TpTime Interval 

The period over which the fault statistics are to be generated. Supplying both a start time and stop time as empty strings 
leaves the time period to the discretion of the client application. 

7.3.3.2 Interface Class IpFaultManager 

Inherits from: Iplnterface. 

This interface is used by the application to inform the framework of events that affect the integrity of the framework 
and services, and to request information about the integrity of the system. The fault manager operations do not 
exchange callback interfaces as it is assumed that the client application supplies its Fault Management callback 
interface at the time it obtains the Framework's Fault Management interface, by use of the obtainlnterfaceWithCallback 
operation on the IpAccess interface. 

If the IpFaultManager interface is implemented by a Framework, at least one of these methods shall be 
implemented. If the Framework is capable of invoking the IpAppFaultManager.appActivityTestReqO method, it shall 
implement appActivityTestRes() and appActivityTestErr() in this interface. If the Framework is capable of invoking 
IpAppFaultManager.genFaultStatsRecordReqO, it shall implement genFaultStatsRecordRes() and 
genFaultStatsRecordErrO in this interface. 

«lnterface» 
IpFaultManager 



activitylestReq (activitylestlD : in TpActivityTestID, svcID : in TpServicelD) : void 

appActivitylestRes (activitylestlD : in TpActivityTestID, activityTestResult : in TpActivityTestRes) : void 

svcUnavailableInd (servicelD : in TpServicelD) : void 

genPaultStatsRecordReq (timePeriod : in TpTimelnterval, servicelDs : in TpServicelDList) : void 
appActivityTestErr (activityTestID : in TpActivityTestID) : void 
appUnavailableInd (servicelD : in TpServicelD) : void 
genPaultStatsRecordRes (faultStatistics : in TpPaultStatsRecord) : void 
genPaultStatsRecordErr (faultStatisticsError : in TpPaultStatisticsError) : void 



Method 

activityTestReq ( ) 

The application invokes this method to test that the framework or its instance of a service is operational. On receipt of 
this request, the framework must carry out a test on itself or on the client's instance of the specified service, to check 
that it is operating correctly. The framework reports the test result by invoking the activityTestRes method on the 
IpAppFaultManager interface. If the application does not have access to a service instance with the specified servicelD, 
the P_UNAUTHORISED_PARAMETER_VALUE exception shall be thrown. The extralnformation field of the 
exception shall contain the corresponding servicelD. 

For security reasons the client application has access to the service ID rather than the service instance ID. However, as 
there is a one to one relationship between the client application and a service, i.e. there is only one service instance of 
the specified service per client application, it is the obligation of the framework to determine the service instance ID 
from the service ID. 
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Parameters 

activityTestID : in TpActivityTestID 

The identifier provided by the client appUcation to correlate the response (when it arrives) with this request. 
svcID : in TpServicelD 

Identifies either the framework or a service for testing. The framework is designated by an empty string. 
Raises 

TpCommonExceptions, P_INVALID_SERVICE_ID, P_UNAUTHORISED_PARAMETER_VALUE 



Method 

appActivityTestRes () 

The client apphcation uses this method to return the result of a framework-requested activity test. 
Parameters 

activityTestID : in TpActivityTestID 

Used by the framework to correlate this response (when it arrives) with the original request. 

activityTestResult : in TpActivityTestRes 

The result of the activity test. 

Raises 

TpCommonExceptions, P_INVALID_SERVICE_ID, P_INVALID_ACTIVITY_TEST_ID 



Method 

svcUnavailableInd ( ) 

This method is used by the client application to inform the framework that it can no longer use its instance of the 
indicated service (either due to a failure in the chent apphcation or in the service instance itself). On receipt of this 
request, the framework should take the appropriate corrective action. The framework assumes that the session between 
this client application and service instance is to be closed and updates its own records appropriately as well as 
attempting to inform the service instance and/or its administrator. Attempts by the client application to continue using 
this session should be rejected. If the application does not have access to a service instance with the specified 
servicelD, the P_UNAUTHORISED_PARAMETER_VALUE exception shall be thrown. The extralnformation field 
of the exception shall contain the corresponding servicelD. 

Parameters 

servicelD : in TpServicelD 

Identifies the service that the apphcation can no longer use. 

Raises 

TpCommonExceptions, P_INVALID_SERVICE_ID, P_UNAUTHORISED_PARAMETER_VALUE 
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Method 

genFaultStatsRecordReq ( ) 

This method is used by the application to solicit fault statistics from the framework. On receipt of this request the 
framework must produce a fault statistics record, for either the framework or for the client's instances of the specified 
services during the specified time interval, which is returned to the client appUcation using the genFaultStatsRecordRes 
operation on the IpAppFaultManager interface. If the application does not have access to a service instance with the 
specified servicelD, the P_UNAUTHORISED_PARAMETER_VALUE exception shall be thrown. The 
extralnformation field of the exception shall contain the corresponding servicelD. 

Parameters 

timePeriod : in TpTime Interval 

The period over which the fault statistics are to be generated. Supplying both a start time and stop time as empty strings 
leaves the time period to the discretion of the framework. 

servicelDs : in TpServicelDList 

Specifies either the framework or services to be included in the general fault statistics record. If this parameter is not an 
empty list, the fault statistics records of the client's instances of the specified services are returned, otherwise the fault 
statistics record of the framework is returned. 

Raises 

TpCommonExceptions, P_INVALID_SERVICE_ID, P_UNAUTHORISED_PARAMETER_VALUE 

Method 

appActivityTestErr ( ) 

The client application uses this method to indicate that an error occurred during a framework-requested activity test. 
Parameters 

activityTestID : in TpActivityTestID 

Used by the framework to correlate this response (when it arrives) with the original request. 
Raises 

TpCommonExceptions , P_INVALID_ACTIVITY_TEST_ID 

Method 

appUnavailableInd ( ) 

This method is used by the application to inform the framework that it is ceasing its use of the service instance. This 
may a result of the application detecting a failure. The framework assumes that the session between this client 
apphcation and service instance is to be closed and updates its own records appropriately as well as attempting to 
inform the service instance and/or its administrator. 

Parameters 

servicelD : in TpServicelD 

Identifies the affected application. 
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Raises 

TpCommonExceptions 

Method 

genFaultStatsRecordRes () 

This method is used by the client appHcation to provide fauh statistics to the framework in response to a 
genFauhStatsRecordReq method invocation on the IpAppFauhManager interface. 

Parameters 

f aultStatistics : in TpFaultStatsRecord 

The fauh statistics record. 

Raises 

TpCommonExceptions 

Method 

genFaultStatsRecordErr () 

This method is used by the cHent application to indicate an error fulfilling the request to provide fault statistics, in 
response to a genFauhStatsRecordReq method invocation on the IpAppFauhManager interface. 

Parameters 

f aultStatisticsError : in TpFaultStatisticsError 

The fault statistics error. 

Raises 

TpCommonExceptions 

7.3.3.3 Interface Class IpAppHeartBeatMgmt 

Inherits from: Iplnterface. 

This interface allows the initialisation of a heartbeat supervision of the client application by the framework. 

«lnterface» 
IpAppHeartBeatMgmt 



enableAppHeartBeat (interval : in Tplnt32, fwlnterface : in IpHeartBeatRef) : void 
disableAppHeartBeat () : void 
changelnterval (interval : in Tplnt32) : void 
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Method 

enableAppHeartBeat ( ) 

With this method, the framework instructs the client application to begin sending its heartbeat to the specified interface 
at the specified interval. 

Parameters 

interval : in Tplnt32 

The time interval in milliseconds between the heartbeats. 

fwlnterface : in IpHeartBeatRef 

This parameter refers to the callback interface the heartbeat is calling. 

Method 

disableAppHeartBeat () 

Instructs the client application to cease the sending of its heartbeat. 
Parameters 

No Parameters were identified for this method 



Method 

change Interval ( ) 

Allows the administrative change of the heartbeat interval. 
Parameters 

interval : in Tplnt32 

The time interval in milliseconds between the heartbeats. 

7.3.3.4 Interface Class IpAppHeartBeat 

Inherits from: Iplnterface. 

The Heartbeat Application interface is used by the Framework to send the client application its heartbeat. 

«lnterface» 
IpAppHeartBeat 



pulse : void 
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Method 
pulse ( ) 

The framework uses this method to send its heartbeat to the client application. The application will be expecting a pulse 
at the end of every interval specified in the parameter to the IpHeartBeatMgmt.enableHeartbeat() method. If the pulse() 
is not received within the specified interval, then the framework can be deemed to have failed the heartbeat. 

Parameters 

No Parameters were identified for this method 

7.3.3.5 Interface Class IpHeartBeatMgmt 

Inherits from: Iplnterface. 

This interface allows the initialisation of a heartbeat supervision of the framework by a client application. If the 
IpHeartBeatMgmt interface is implemented by a Framework, as a minimum enableHeartBeat() and disableHeartBeat() 
shall be implemented. 

«lnterface» 
IpHeartBeatMgmt 



enableHeartBeat (interval : in Tplnt32, applnterface : in IpAppHeartBeatRef) : void 
disableHeartBeat () : void 
changelnterval (interval : in Tplnt32) : void 



Method 

enableHeartBeat ( ) 

With this method, the client application instructs the framework to begin sending its heartbeat to the specified interface 
at the specified interval. 

Parameters 

interval : in Tplnt32 

The time interval in milhseconds between the heartbeats. 

applnterface : in IpAppHeartBeatRef 

This parameter refers to the callback interface the heartbeat is calling. 

Raises 

TpCommonExceptions 

Method 

disableHeartBeat () 

Instructs the framework to cease the sending of its heartbeat. 
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Parameters 

No Parameters were identified for this method 
Raises 

TpCommonExceptions 



Method 

change Interval () 

Allows the administrative change of the heartbeat interval. 
Parameters 

interval : in Tplnt32 

The time interval in milliseconds between the heartbeats. 

Raises 

TpCommonExceptions 



7.3.3.6 Interface Class IpHeartBeat 

Inherits from: Iplnterface. 

The Heartbeat Framework interface is used by the client application to send its heartbeat. If a Framework is capable of 
invoking IpAppHeartBeatMgmt.enableHeartBeat(), it shall implement IpHeartBeat and the pulse() method. 

«lnterface» 
IpHeartBeat 



pulse : void 



Method 
pulse ( ) 

The client application uses this method to send its heartbeat to the framework. The framework will be expecting a pulse 
at the end of every interval specified in the parameter to the IpAppHeartBeatMgmt.enableAppHeartbeat() method. If 
the pulseO is not received within the specified interval, then the framework can be deemed to have failed the heartbeat. 

Parameters 

No Parameters were identified for this method 
Raises 

TpCommonExceptions 
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7.3.3.7 Interface Class IpAppLoadManager 

Inherits from: Iplnterface. 

The client application developer supplies the load manager application interface to handle requests, reports and other 
responses from the framework load manager function. The application supplies the identity of this callback interface at 
the time it obtains the framework's load manager interface, by use of the obtainInterfaceWithCallback() method on the 
IpAccess interface. 

«lnterface» 
IpAppLoadManager 



queryAppLoadReq (timelnterval : in TpTimelnterval) : void 
queryLoadRes (loadStatistics : in TpLoadStatisticList) : void 
queryLoadErr (loadStatisticsError : in TpLoadStatisticError) : void 
loadLevelNotification (loadStatistics : in TpLoadStatisticList) : void 
resumeNotification () : void 
suspendNotification () : void 
«new» createLoadLevelNotification () : void 
«new» destroyLoadLevelNotification () : void 



Method 

queryAppLoadReq ( ) 

The framework uses this method to request the application to provide load statistics records for the application. 
Parameters 

timelnterval : in TpTimelnterval 

Specifies the time interval for which load statistic records should be reported. 
Method 

queryLoadRes ( ) 

The framework uses this method to send load statistic records back to the application that requested the information; i.e. 
in response to an invocation of the queryLoadReq method on the IpLoadManager interface. 

Parameters 

loadStatistics : in TpLoadStatisticList 

Specifies the framework-supplied load statistics 
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Method 

query LoadErr ( ) 

The framework uses this method to return an error response to the application that requested the framework's load 
statistics information, when the framework is unsuccessful in obtaining any load statistic records; i.e. in response to an 
invocation of the queryLoadReq method on the IpLoadManager interface. 

Parameters 

loadStatisticsError : in TpLoadStatisticError 

Specifies the error code associated with the failed attempt to retrieve the framework's load statistics. 
Method 

loadLevelNotif ication 

Upon detecting load condition change, (e.g. load level changing from to 1, to 2, 1 to 0, for the SCFs or framework 
which have been registered for load level notifications) this method is invoked on the apphcation. In addition this 
method shall be invoked on the application in order to provide a notification of current load status, when load 
notifications are first requested, or resumed after suspension. 

Parameters 

loadStatistics : in TpLoadStatisticList 

Specifies the framework- supplied load statistics, which include the load level change(s). 
Method 

resiimeNotif ication 

The framework uses this method to request the application to resume sending it notifications: e.g. after a period of 
suspension during which the framework handled a temporary overload condition. Upon receipt of this method the 
cUent application shall inform the framework of the current load using the reportLoad method on the corresponding 
IpLoadManager. 

Parameters 

No Parameters were identified for this method 



Method 

suspendNotif ication 

The framework uses this method to request the application to suspend sending it any notifications: e.g. while the 
framework handles a temporary overload condition. 

Parameters 

No Parameters were identified for this method 
Method 

«new» createLoadLevelNotif ication ( ) 

The framework uses this method to register to receive notifications of load level changes associated with the 
application. Upon receipt of this method the client application shall inform the framework of the current load using the 
reportLoad method on the corresponding IpLoadManager. 
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Parameters 

No Parameters were identified for this method 
Method 

«new» destroyLoadLevelNotif ication () 

The framework uses this method to unregister for notifications of load level changes associated with the application. 
Parameters 

No Parameters were identified for this method 



7.3.3.8 Interface Class IpLoadManager 

Inherits from: Iplnterface. 

The framework API should allow the load to be distributed across multiple machines and across multiple component 
processes, according to a load management policy. The separation of the load management mechanism and load 
management policy ensures the flexibility of the load management services. The load management policy identifies 
what load management rules the framework should follow for the specific client application. It might specify what 
action the framework should take as the congestion level changes. For example, some real-time critical applications will 
want to make sure continuous service is maintained, below a given congestion level, at all costs, whereas other services 
will be satisfied with disconnecting and trying again later if the congestion level rises. Clearly, the load management 
policy is related to the QoS level to which the application is subscribed. The framework load management function is 
represented by the IpLoadManager interface. Most methods are asynchronous, in that they do not lock a thread into 
waiting whilst a transaction performs. To handle responses and reports, the client application developer must 
implement the IpAppLoadManager interface to provide the callback mechanism. The application supplies the identity 
of this callback interface at the time it obtains the framework's load manager interface, by use of the 
obtainlnterfaceWithCallback operation on the IpAccess interface. 

If the IpLoadManager interface is implemented by a Framework, at least one of the methods shall be implemented 
as a minimum requirement. If load level notifications are supported, the createLoadLevelNotification() and 
destroyLoadLevelNotificationO methods shall be implemented. If suspendNotification() is implemented, then 
resumeNotificationO shall be implemented also. If a Framework is capable of invoking the 

IpAppLoadManager.queryAppLoadReqO method, then it shall implement query AppLoadRes() and queryAppLoadErr() 
methods in this interface. 

«lnterface» 
IpLoadManager 



reportLoad (loadLevel : in TpLoadLevel) : void 

queryLoadReq (servicelDs : in TpServicelDList, timelnterval : in TpTimelnterval) : void 
queryAppLoadRes (loadStatistics : in TpLoadStatisticList) : void 
queryAppLoadErr (loadStatisticsError : in TpLoadStatisticError) : void 
createLoadLevelNotification (servicelDs : in TpServicelDList) : void 
destroyLoadLevelNotification (servicelDs : in TpServicelDList) : void 
resumeNotification (servicelDs : in TpServicelDList) : void 
suspendNotification (servicelDs : in TpServicelDList) : void 
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Method 

reportLoad ( ) 

The client application uses this method to report its current load level (0,1, or 2) to the framework: e.g. when the load 
level on the application has changed. In addition this method shall be called by the application in order to report current 
load status, when load notifications are first requested, or resumed after suspension. 

At level load, the application is performing within its load specifications (i.e. it is not congested or overloaded). At 
level 1 load, the application is overloaded. At level 2 load, the application is severely overloaded. 

Parameters 

loadLevel : in TpLoadLevel 

Specifies the appUcation's load level. 

Raises 

TpCommonExcep'tions 



Method 

query LoadReq ( ) 

The client appUcation uses this method to request the framework to provide load statistic records for the framework or 
for its instances of the individual services. If the application does not have access to a service instance with the 
specified servicelD, the P_UNAUTHORISED_PARAMETER_VALUE exception shall be thrown. The 
extralnformation field of the exception shall contain the corresponding servicelD. 

Parameters 

servicelDs : in TpServicelDList 

Specifies the framework or the services for which load statistics records should be reported. If this parameter is not an 
empty list, the load statistics records of the client's instances of the specified services are returned, otherwise the load 
statistics record of the framework is returned. 

-timeln-terval : in TpTimelnterval 

Specifies the time interval for which load statistics records should be reported. 
Raises 

TpCommonExceptions, P_INVALID_SERVICE_ID, P_SERVICE_NOT_ENABLED, 
P_UNAUTHORI SED_PARAMETER_VALUE 



Method 

queryAppLoadRes ( ) 

The client application uses this method to send load statistic records back to the framework that requested the 
information; i.e. in response to an invocation of the queryAppLoadReq method on the IpAppLoadManager interface. 

Parameters 

loadStatistics : in TpLoadStatisticList 

Specifies the appUcation-suppIied load statistics. 
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Raises 

TpCommonExcep'tions 



Method 

queryAppLoadErr ( ) 

The client application uses this method to return an error response to the framework that requested the appUcation's load 
statistics information, when the application is unsuccessful in obtaining any load statistic records; i.e. in response to an 
invocation of the query AppLoadReq method on the IpAppLoadManager interface. 

Parameters 

loadSta'tisticsError : in TpLoadStatis'ticError 

Specifies the error code associated with the failed attempt to retrieve the application's load statistics. 

Raises 

TpCommonExceptions 



Method 

createLoadLevelNotif ication 

The client apphcation uses this method to register to receive notifications of load level changes associated with either 
the framework or with its instances of the individual services used by the application. If the application does not have 
access to a service instance with the specified servicelD, the P_UNAUTHORISED_PARAMETER_VALUE exception 
shall be thrown. The extralnformation field of the exception shall contain the corresponding servicelD. Upon receipt 
of this method the framework shall inform the client application of the current framework or service instance load using 
the loadLevelNotification method on the corresponding IpAppLoadManager. 

Parameters 

servicelDs : in TpServicelDList 

Specifies the framework or SCFs to be registered for load control. To register for framework load control, the 
servicelDs parameter must be an empty list. 

Raises 

TpCommonExceptions, P_INVALID_SERVICE_ID, P_UNAUTHORISED_PARAMETER_VALUE 



Method 

destroyLoadLevelNotif ication 

The client application uses this method to unregister for notifications of load level changes associated with either the 
framework or with its instances of the individual services used by the application. If the application does not have 
access to a service instance with the specified servicelD, the P_UNAUTHORISED_PARAMETER_VALUE exception 
shall be thrown. The extralnformation field of the exception shall contain the corresponding servicelD. 
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Parameters 

servicelDs : in TpServicelDList 

Specifies the framework or the services for which load level changes should no longer be reported. To unregister for 
framework load control, the servicelDs parameter must be an empty Ust. 

Raises 

TpCommonExceptions, P_INVALID_SERVICE_ID, P_UNAUTHORISED_PARAMETER_VALUE 



Method 

resxuneNotif ication ( ) 

The client application uses this method to request the framework to resume sending it load management notifications 
associated with either the framework or with its instances of the individual services used by the application; e.g. after a 
period of suspension during which the appUcation handled a temporary overload condition. If the apphcation does not 
have access to a service instance with the specified servicelD, the P_UNAUTHORISED_PARAMETER_VALUE 
exception shall be thrown. The extralnformation field of the exception shall contain the corresponding servicelD. 
Upon receipt of this method the framework shall inform the client application of the current framework or service 
instance load using the loadLevelNotification method on the corresponding IpAppLoadManager. 

Parameters 

servicelDs : in TpServicelDLis't 

Specifies the framework or the services for which the sending of notifications of load level changes by the framework 
should be resumed. To resume notifications for the framework, the servicelDs parameter must be an empty list. 

Raises 

TpCommonExceptions, P_INVALID_SERVICE_ID, P_SERVICE_NOT_ENABLED, 
P_UNAUTHORI SED_PARAMETER_VALUE 



Method 

suspendNotif ication 

The client application uses this method to request the framework to suspend sending it load management notifications 
associated with either the framework or with its instances of the individual services used by the apphcation; e.g. while 
the application handles a temporary overload condition. If the application does not have access to a service instance 
with the specified servicelD, the P_UNAUTHORISED_PARAMETER_VALUE exception shall be thrown. The 
extralnformation field of the exception shall contain the corresponding servicelD. 

Parameters 

servicelDs : in TpServicelDList 

Specifies the framework or the services for which the sending of notifications by the framework should be suspended. 
To suspend notifications for the framework, the servicelDs parameter must be an empty list. 

Raises 

TpCommonExceptions, P_INVALID_SERVICE_ID, P_SERVICE_NOT_ENABLED, 
P_UNAUTHORI SED_PARAMETER_VALUE 
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7.3.3.9 Interface Class IpOAM 

Inherits from: Iplnterface. 

The OAM interface is used to query the system date and time. The application and the framework can synchronise the 
date and time to a certain extent. Accurate time synchronisation is outside the scope of the OSA APIs. This interface 
and the systemDateTimeQueryO method are optional. 

«lnterface» 
IpOAM 



systemDateTimeQuery (clientDateAndTime : in TpDateAndTime) : TpDateAndTime 



Method 

systemDateTimeQuery ( ) 

This method is used to query the system date and time. The client application passes in its own date and time to the 
framework. The framework responds with the system date and time. 

Returns <systemDateAndTime> : This is the system date and time of the framework. 
Parameters 

ClientDateAndTime : in TpDateAndTime 

This is the date and time of the client (application). The error code P_INVALID_DATE_TIME_FORMAT is returned if 
the format of the parameter is invalid. 

Returns 

TpDateAndTime 

Raises 

TpCommonExceptions , P_INVALID_TIME_AND_DATE_FORMAT 

7.3.3.10 Interface Class IpAppOAM 

Inherits from: Iplnterface. 

The OAM client application interface is used by the Framework to query the application date and time, for 
synchronisation purposes. This method is invoked by the Framework to interchange the framework and client 
application date and time. 

«lnterface» 
IpAppOAM 



systemDateTimeQuery (system DateAndTime : in TpDateAndTime) : TpDateAndTime 
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Method 

systemDateTimeQuery ( ) 

This method is used to query the system date and time. The framework passes in its own date and time to the 
appHcation. The appHcation responds with its own date and time. 

Returns <clientDateAndTime> : This is the date and time of the cHent (appHcation). 
Parameters 

systemDateAndTime : in TpDateAndTime 

This is the system date and time of the framework. 

Returns 

TpDateAndTime 

7.3.4 Event Notification Interface Classes 
7.3.4.1 Interface Class IpAppEventNotification 

Inherits from: Iplnterface. 

This interface is used by the services to inform the application of a generic service-related event. The Event 
Notification Framework will invoke methods on the Event Notification Application Interface that is specified when the 
Event Notification interface is obtained. 

«lnterface» 
IpAppEventNotification 



reportNotification (eventlnfo : in TpFwEventlnfo, assignmentID : in TpAssignmentID) : void 
notificationlerminated () : void 



Method 

reportNotification () 

This method notifies the application of the arrival of a generic event. 
Parameters 

eventlnfo : in TpFwEventlnfo 

Specifies specific data associated with this event. 

assignmentID : in TpAssignmentID 

Specifies the assignment id which was returned by the framework during the createNotification() method. The 
application can use assignment id to associate events with event specific criteria and to act accordingly. 
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Method 

notif icationTerminated ( ) 

This method indicates to the apphcation that all generic event notifications have been terminated (for example, due to 
faults detected). 

Parameters 

No Parameters were identified for this method 

7.3.4.2 Interface Class IpEventNotification 

Inherits from: Iplnterface. 

The event notification mechanism is used to notify the application of generic service related events that have occurred. 
If Event Notifications are supported by a Framework, this interface and the createNotification() and 
destroyNotificationO methods shall be implemented. 

«lnterface» 
IpEventNotification 



createNotification (eventCriteria : in TpFwEventCriteria) : TpAssignmentID 
destroyNotification (assignmentID : in TpAssignmentID) : void 



Method 

createNotification ( ) 

This method is used to enable generic notifications so that events can be sent to the application. 

Returns <assignmentID> : Specifies the ID assigned by the framework for this newly installed notification. 

Parameters 

eventCriteria : in TpFwEventCriteria 

Specifies the event specific criteria used by the application to define the event required. 
Returns 

TpAssignmentID 

Raises 

TpCommonExceptions, P_ACCESS_DENIED, P_INVALID_CRITERIA, 
P INVALID EVENT TYPE 



Method 

destroyNotification ( ) 

This method is used by the application to delete generic notifications from the framework. 
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Parameters 

assignmentID : in TpAssignmentID 

Specifies the assignment ID given by the framework when the previous createNotification() was called. If the 
assignment ID does not correspond to one of the valid assignment IDs, the framework will return the error code 
P_INVALID_ASSIGNMENTID. 

Raises 

TpCommonExceptions, P_ACCESS_DENIED, P_INVALID_ASSIGNMENT_ID 



This clause contains the State Transition Diagrams for the objects that implement the Framework interfaces on the 
gateway side. The State Transition Diagrams show the behaviour of these objects. For each state the methods that can 
be invoked by the application are shown. Methods not shown for a specific state are not relevant for that state and will 
return an exception. Apart from the methods that can be invoked by the application also events internal to the gateway 
or related to network events are shown together with the resulting event or action performed by the gateway. These 
internal events are shown between quotation marks. 



7.4 



State Transition Diagrams 



7.4.1 



Service Discovery State Transition Diagrams 



7.4.1.1 



State Transition Diagrams for IpServiceDiscovery 




obtainFrameworklnterface( discoveryService ) 
obtainlntertaceWithCallback( discoveryService ) 



listServiceTypes 




IpAccess.endAccess 




Figure : State Transition Diagram for IpServiceDiscovery 
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7.4.1.1.1 Active State 

When the application requests Service Discovery by invoking the obtainlnterface or the obtainlnterfaceWithCallback 
methods on the IpAccess interface, an instance of the IpServiceDiscovery will be created. Next the application is 
allowed to request a hst of the provided SCFs and to obtain a reference to interfaces of SCFs. 

7.4.2 Service Agreement Management State Transition Diagrams 

There are no State Transition Diagrams defined for Service Agreement Management 



7.4.3 Integrity Management State Transition Diagrams 
7.4.3.1 State Transition Diagrams for IpLoadManager 



createLoadLevelNotification '^loadLewlNolification 



reportLoad 

"load change" '^loadLevelNotificati on querySvcLoadRes[ load statistics requested by LoadManager ] 

querySvcLoadErr[ load statistics requested by LoadManager ] 
queryLoadReq 



Active 




destroyLoadLevelNotification 



IpAccessN^btainhtepface 
lpAccess\^inliyiterfaceWithCallback 



resumeNoti fi cation 
'^loadLe\elNo1)fication 




suspendNotification 
[all notifications suspended ] 



reportLoad 

querySvcLoadRes[ load statistics requested by LoadManager ] 

. querySvcLoadErr[ load statistics requested by LoadManager ] 

Notification queryLoadReq 



destroyLoadLevelNotification 



Suspended 



IpAcces s.endA;cess 



Figure : State Transition Diagram for lpLoadl\/lanager 

7.4.3.1.1 Idle State 

In this state the application has obtained an interface reference of the LoadManager from the IpAccess interface. 
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7.4.3.1 .2 Notification Suspended State 

Due to e.g. a temporary load condition, the application has requested the LoadManager to suspend sending the load 
level notification information. 



7.4.3.1.3 Active State 

In this state the application has indicated its interest in notifications by performing a createLoadLevelNotification() 
invocation on the IpLoadManager. The load manager can now request the application to supply load statistics 
information (by invoking query AppLoadReqO). Furthermore the LoadManager can request the application to control its 
load (by invoking loadLevelNotification(), resumeNotification() or suspendNotification() on the application side of 
interface). In case the application detects a change in load level, it reports this to the LoadManager by calling the 
method reportLoad(). 



7.4.3.2 State Transition Diagrams for LoadlVlanagerlnternal 



regiStetLoadController 



reportLoad[ loadlevel != ] 



Normal load 




reportLoad[ loadlevel = ] 



"iraernal load change detection" 
"internal load change it) non o\erloaded' 




A necessary action can 
be suspending the load 
notifictions to the 
application or enabling 
load control mechanisms 
on certain services. 



Application Overload 



'interrial load change detection" 
"internal load change/fo non qverload" 



Internal overload 



reportLoad[ loadlevel != ] 



V 

Internal and Application Overload 



reportLoad[ load level = ] 



A necessary action can be 
suspending the load 
notifctions from the 
application by invoking 
suspendNotification or 
enabling load control 
mechanisms on the 
application by invoking 
enableLoad Control. 



ALL 
STATES 



unreglste •LoadControler 



Figure : State Transition Diagram for LoadlVlanagerlnternal 

7.4.3.2.1 Normalload State 

In this state the none of the entities defined in the load balancing policy between the application and the framework / 
SCFs is overloaded. 
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7.4.3.2.2 Application Overload State 

In this state the application has indicated it is overloaded. When entering this state the load policy is consulted and the 
appropriate actions are taken by the LoadManager. 



7.4.3.2.3 Internal overload State 

In this state the Framework or one or more of the SCFs within the specific load policy is overloaded. When entering this 
state the load policy is consulted and the appropriate actions are taken by the LoadManager. 



7.4.3.2.4 Internal and Application Overload State 

In this state the application is overloaded as well as the Framework or one or more of the SCFs within the specific load 
policy. When entering this state the load policy is consulted and the appropriate actions are taken by the LoadManager. 



7.4.3.3 State Transition Diagrams for IpOAM 



IpAccess . obtai n Interface 
IpAccess.obtainlnterfaceWithCallback 



system DateTimeQuery 



Active 



IpAccess . endAccess 

\/ 



Figure : State Transition Diagram for IpOAIUi 



7.4.3.3.1 Active State 

In this state the application has obtained a reference to the IpOAM interface. The application is now able to request the 
date / time of the Framework. 



7.4.3.4 State Transition Diagrams for IpFaultManager 
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lpAccess.obtainlnterfaceWithCallback( "FaultManagement" ) / 
add application to fault m anagement 



'service fault' "svcUnavailablelnd to all applicationsusing the service 

\ srvUnavailablelrid / test the service, inform service that application is not using it 
genFau ItStatsRecord Req ^app.genFau ItStatsRecord Res 



sen/ice fault '^srvUnavailablelnd to all applicationsusing the service 




entry/ '^fwFaultReportlnd to all applicationswith callback 
exit/ "fwFaultRecoverylnd to all applicationswith callback 



Figure : State Transition Diagram for IpFaultlVlanager 

7.4.3.4.1 Framework Active State 

This is the normal state of the frame'work, ■which is fully functional and able to handle requests from both applications 
and services capability features. 

7.4.3.4.2 Framework Faulty State 

In this state, the frame'work has detected an internal problem with itself such that application and services capability 
features cannot communicate with it anymore; attempts to invoke any methods that belong to any SCFs of the 
framework return an error. If the framework ever recovers, applications with fault management callbacks will be 
notified via a fwFaultRecoveryInd message. 

7.4.3.4.3 Framework Activity Test State 

In this state, the framework is performing self-diagnostic test. If a problem is diagnosed, all applications with fault 
management callbacks are notified through a fwFaultReportInd message. 

7.4.3.4.4 Service Activity Test State 

In this state, the framework is performing a test on one service capability feature. If the SCF is faulty, applications with 
fault management callbacks are notified accordingly through a svcUnavailableInd message. 

7.4.4 Event Notification State Transition Diagrams 
7.4.4.1 State Transition Diagrams for IpEventNotification 
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Figure : State Transition Diagram for IpEventNotification 



8 Framework-to-Service API 

8.1 Sequence Diagrams 

8.1 .1 Service Discovery Sequence Diagrams 

No Sequence Diagrams exist for Service Discovery 

8.1 .2 Service Registration Sequence Diagrams 
8.1 .2.1 New SCF Registration 

The following figure shows the process of registering a new Service Capability Feature in the Framework. Service 
Registration is a two step process: 
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scs 



IpFwServiceReqistration 



1 : registerService( 



2: announceServiceAvailability( 



1 : Registration: first step - register service 

The purpose of this first step in the process of registration is to agree, within the network, on a name to call, internally, a 
newly installed SCF version. It is necessary because the OSA Framework and SCF in the same network may come from 
different vendors. The goal is to make an association between the new SCF version, as characterized by a list of 
properties, and an identifier called servicelD. 

This service ID will be the name used in that network (that is, between that network's Framework and its SCSs), 
whenever it is necessary to refer to this newly installed version of SCF (for example for announcing its availability, or 
for withdrawing it later). 

The following input parameters are given from the SCS to the Framework in this first registration step: 
in serviceTypeName 

This is a string with the name of the SCF, among a list of standard names (e.g. "P_MPCC"). 
in servicePropertyList 

This is a list of types TpServiceProperty; each TpServiceProperty is a pair of (ServicePropertyName, 
ServicePropertyValueList). 

ServicePropertyName is a string that defines a valid SFC property name (valid SCF property names are listed in the 
SCF data definition). 

ServicePropertyValueList is a numbered set of types TpServicePropertyValue; TpServicePropertyValue is a string 
that describes a valid value of a SCF property (valid SCF property values are listed in the SCF data definition). 

The following output parameter results from service registration: 

out servicelD 

This is a string, automatically generated by the Framework and unique within the Framework. 

This is the name by which the newly installed version of SCF, described by the list of properties above, is going to be 
identified internally in this network. 

2: Registration: second step - announce service availability 
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At this point the network's Framework is aware of the existence of a new SCF, and could let applications know - but 
they would have no way to use it. Installing the SCS logic and assigning a name to it does not make this SCF available. 
In order to make the SCF available an "entry point", called lifecycle manager, is used. The role of the lifecycle manager 
is to control the life cycle of an interface, or set of interfaces, and provide clients with the references that are necessary 
to invoke the methods offered by these interfaces. The starting point for a client to use an SCF is to obtain an interface 
reference to a lifecycle manager of the desired SCF. 

A Network Operator, upon completion of the first registration phase, and once it has an identifier to the new SCF 
version, will instantiate a lifecycle manager for it that will allow client to use it. Then it will inform the Framework of 
the value of the interface associated to the new SCF. After the receipt of this information, the Framework makes the 
new SCF (identified by the pair [servicelD, servicelnstanceLifecycleManagerRef]) discoverable. 

The following input parameters are given from the SCS to the Framework in this second registration step: 

in servicelD 

This is the identifier that has been agreed in the network for the new SCF; any interaction related to the SCF needs to 
include the servicelD, to know which SCF it is. 

in servicelnstanceLifecycleManagerRef 

This is the interface reference at which the lifecycle manager of the new SCF is available. Note that the Framework will 
have to invoke the method createServiceManager() in this interface, any time between now and when it accepts the first 
application requests for discovery, so that it can get the service manager interface necessary for applications as an entry 
point to any SCF. 



8.1.3 Service Instance Lifecycle Manager Sequence Diagrams 
8.1 .3.1 Sign Service Agreement 

This sequence illustrates how the application can get access to a specified service. It only illustrates the last part: the 
signing of the service agreement and the corresponding actions towards the service. For more information on accessing 
the framework, authentication and discovery of services, see the corresponding clauses. 









: IpAppCalControlWanager 










IpAopServiceAgreem entManagem ent 






IpServiceAqreement Management 



We assume that the applicalion is already authenticated and dEcoveredthe service it wants tou! 



1: seiectServ ice.( ) 



2: sigiliServiceAgreement( ) 



3: signServbeAgreenjientl ] 



GenericCailContrQiService : 
I pServ icel nstanceLIf ecy cleManager 



: IpCallCQntrolManager 



4: createServiceMarHger( ) 



1: The application selects the service, using a servicelD for the generic call control service. The servicelD could have 
been obtained via the discovery interface. A ServiceToken is returned to the application. 

2: The client application signs the service agreement. 

3: The framework signs the service agreement. As a result a service manager interface reference (in this case of type 
IpCallControlManager) is returned to the application. 
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4: Provided the signature information is correct and all conditions have been fulfilled, the framework will request the 
service identified by the servicelD to return a service manager interface reference. The service manager is the initial 
point of contact to the service. 

5: The Ufecycle manager creates a new manager interface instance (a call control manager) for the specified 
application. It should be noted that this is an implementation detail. The service implementation may use other 
mechanism to get a service manager interface instance. 

Following the creation of the service manager outlined above, a unique instance of the service particular to the 
application client results. This service instance is assigned a servicelnstancelD by the Framework, which is provided to 
the Service Instance Lifecycle manager during the createServiceManager operation. If it is necessary that Framework 
Integrity Management functionality and operations are to be supported between the Framework and the service instance 
identified by the defined servicelnstancelD, it is then necessary for the new service instance to establish an access 
session with the Framework. . This provides theFramework with the ability to manage and monitor the operation of the 
service instance that relates to a particular application client. The steps required to establish a Framework access 
session are outlined in chapter 6 of this specification. 

6: The application creates a new IpAppCallControlManager interface to be used for callbacks. 
7: The Application sets the callback interface to the interface created with the previous message. 



8.1 .4 Integrity Management Sequence Diagrams 

8.1 .4.1 Load Management: Service callback registration and load control 

This sequence diagram shows how a service registers itself and the framework invokes load management fimction 
based on policy 
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: IpSvcLoadManaqer 



: IpFwLoadManaqer 



1 : createLoadLevelNotificationf 



Fram ework detects a load 
condition change 
and notifies the service. The 
service m aytal<e appropriate 
load control action - 
implementation detail. 



2: loadLevelNotification( ) 



Framework reports its initial load t\ 
condition on notification creation 



3: load change detection & policy evaluation 



4: loadLevelNotification( ] 



This is Framework 
implementation detail. The 
Framework may take appropriate 
load control action. 



5: load change detection & policy evaluation 



6: roadLevelNotification( ) 



7: destroyLoadLevelNotification( ; 



This is Framework 
implementation detail. The 
Framework may take appropriate 
load control action. 



8.1 .4.2 Load Management: Framework callback registration and service load control 

This sequence diagram shows how the framework registers itself and the service invokes load management function to 
inform the framework of service load. 
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lpS\A:LoadManaqer 



IpFwLoadManaqer 



Service reports its initial 
load condition on 
notification creation 



This is service 
implementation detail. 
The service may take 
appropriate load control 
action. 



1: createljoadLevelNotification( ] 



2: report Load ( ; 



ioacTchange detection 



4: report Load ( ) 



-^1 



This is service 
implementation detail. 
The service may take 
appropriate load control 
action. 



-,5: load 



change detection 



Service detects a load 
condition change and reports 
to framework. The Framework 
may take appropriate load 
control action - 
implementation detail. 



6: report Load ( ) 



-^1 



7: destroyLoadLevelNotification( ' 



8.1 .4.3 Load Management: Client and Service Load Balancing 
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Application : 
IpAppLoadlVlanaqer 



Framework : 
IpLoadlVlanaqer 



IpFwLoadlVlanaqer 



Service : 
IpSvcLoadlVlanaqer 



Framework checks 
application load. 



1 : queryAppLoadReq( ) 



2: queryAppLoadRes( ) 



Depending on the load, the 
framework may choose to stop 
sending notifications to the 
application, to allow its load to 
reduce. 



3: querySvcLoadReq( ) 



The framework may then che^k K 
the load on the service, and take 
action if (according to the load 
balancing policy) if required. 



4: querySvcLoadRes( ) 



8.1 .4.4 Heartbeat Management: Start/perform/end heartbeat supervision of the service 

In this sequence diagram, the framework has decided that it wishes to monitor the service, and has therefore requested 
the service to commence sending its heartbeat. The service responds by sending its heartbeat at the specified interval. 
The framework then decides that it is satisfied with the service's heahh and disables the heartbeat mechanism. If the 
heartbeat was not received from the service within the specified interval, the framework can decide that the service has 
failed the heartbeat and can then perform some recovery action. 
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Framework 



IpFwHeartBeat 



IpSvc Hea rtBeatM gmt 



1 : enable|SvcHeartBeat( ) 



2: pulse( 



3: pulse( ; 



1 L 

1 4: disable 


iSvcHeartBeat( ) 




' ^ 

1 
1 
1 
1 
1 
1 
1 
1 
1 



At a certain point of 
time the frameworl< 
decides to stop 
lieartbeat supervision 



8.1 .4.5 Fault Management: Service requests Framework activity test 



Framework : 
IpFwFaultManaqer 



Service : 
IpSvc Fault Manager 



0" 



1: activityTestReq( 



The Service requests that the 
Framework does an activity test. 



2: activityTestRes( ) 



1: The service asks the framework to carry out its activity test. The service denotes that it requires the activity test done 
for the framework, rather than an appHcation, by supplying an appropriate parameter. 



2: The framework carries out the test and returns the result to the service. 



ETSI 



3GPP TS 29.1 98-03 version 4.9.0 Release 4 88 ETSI TS 1 29 1 98-3 V4.9.0 (2004-06) 

8.1 .4.6 Fault Management: Service requests Application activity test 



Service : 
bS\c Fault Manager 



IpFwFaultManaqer 



Framework : 
IpFaultManaqer 



Application : 
IpAppFaultManaqer 



1: acti\/ityTestReq( 



D 



4: activity TestRes( 

,< 



The Framework identifies the service ^ 
instance to conclude which 
Application the test is directed at, and 
comunicates internally to Framework 
interface to the Application. 



2: appActivityTestReq( ] 



3: appActivityTestRes( 



hternal Framework 
Communications. 



The application 
carries out the 
activity test and 
returns the result to 
the Framework. 



1 : The service asks the framework to invoke an activity test on a cUent application, the appUcation is identified by the 
appid parameter. 

2: The framework asks the appHcation to do the activity test. It is assumed that there is internal communication 
between the service facing part of the framework (i.e. IpFwFaultManager interface) and the part that faces the client 
application. 

3: The application does the activity test and returns the result to the framework. 

4: The framework internally passes the result from its application facing interface (IpFaultManager) to its service 
facing side, and sends the result to the service. 



8.1 .4.7 Fault Management: Application requests Service activity test 



ETSI 



3GPP TS 29.198-03 version 4.9.0 Release 4 



89 



ETSI TS 129 198-3 V4.9.0 (2004-06) 



Client Application : 
IpAppFau It Manager 



Framework : 
IpFaultManaqer 



The client application asks thel\ 
framework to carry out the 
activity test on a service. 



1 : activityTestReq( 



IpFwFaultManaqer 



Service : 
^pSvcFauitlVlanaqer 



The Framework identifies which 
service the test is directed at by the 
svcID parameter, and 
communicates internally with the 
appropriate framework interface. 
Which invokes the call on the 
service. 



2: svcActivityTestReq( ; 



Framework passes result ^ 
internally from service facing 
part to application facing part, 
and sends the result to the 
application. 



4: activity TestRes( 



Service does test and ^ 
returns the result. 



3: s\«ActivityTestRes( 



1 : The client application asks the framework to invoke an activity test on a service, the service is identified by the 
svcid parameter. 

2: The framework asks the service to do the activity test. It is assumed that there is internal communication between 
the application facing part of the framework (i.e. IpFaultManager interface) and the part that faces the service. 

3: The service does the activity test and returns the result to the framework. 

4: The framework internally passes the result from its service facing interface (IpFwFaultManager) to its application 
facing side, and sends the result to the client application. 
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8.1 .4.8 Fault Management: Application detects service is unavailable 



Client Application : 
IpAppFault Manager 



Framework : 
IpFaultManager 



IpFwFaultlVlanager 



Service : 
IpSvcFaultManager 



The application detects that ^ 
the service is not responding, 
so it informs the framework via 
the svcUnavailableInd method 
and then ceases use of the 
service. 



1 : svcUnavailablelnd( ) 



The framework informs the 
service that the application 
is no longer using it. 



2: appUnavailablelnd{ ) 



1: The client application detects that the service instance is currently not available, i.e. the service instance is not 
responding to the client application in the normal way, so it informs the framework and takes action to stop using this 
service instance and change to a different one (via the usual mechanisms, such as discovery, selectService etc.). The 
client application should not need to re-authenticate in order to discover and use an alternative service instance. 

2: The framework informs the service instance that the client application was unable to get a response from it and has 
ceased to be one of its users. The framework and service instance must carry out the appropriate updates to remove the 
client application as one of the users of this service instance. The service or framework may then decide to carry out an 
activity test to see whether there is a general problem with the service instance that requires further action. 



8.1 .5 Event Notification Sequence Diagrams 

No Sequence Diagrams exist for Event Notification 



8.2 Class Diagrams 
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«lnterface» 
IpFwServiceDiscovery 

(from Framework interfaces) 



^listServiceTypesO 
HN^scri beS erviceTy pe() 
^discoverSerMceO 
ll^li stRegi steredServicesO 



Figure: Service Discovery Pacl<age Overview 



«lnterface» 
IpFwServiceRegistration 

(from Framework interfaces) 



%egisterService() 

^announceServiceAvailabilityO 

^unregisterServiceO 
L^describeServiceO 
HunannounceServiceO 



Figure: Service Registration Package Overview 
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«lnterface» 
iDQientAccess 

(from Client interfaces) 



^erminateAccessQ 



«uses» 



«lnterface» 
IpClientAPILevelAuthentication 

(from Client interfaces) 



i^authenticateO 

i^abortAuthenticationO 

l^authenticationSucceededO 



«uses» 



«lnterface» 
Iplnitial 

(from Framework interfaces) 



f initiateAuthenticationQ 



«lntetface» 
IpAccess 

(from Framework interfaces) 



HobtainlnterfaceO 

JbbtainlnterfaceWithCallbackQ 

♦endAccessO 

♦listlnterfacesQ 
^releaselnterfaceO 



«lnterface» 
IpAPILevelAuthentication 

(from Framework interfaces) 



%electEncryptionMethod() 
♦authenticateO 
♦abortAuthenticationO 
♦authenticationSucceededO 



V7 

«lnterface» 
IpAuthentication 

(from Framework interfaces) 



P^requestAccessQ 



Figure: Trust and Security IVIanagement Package Overview 



«lnterface» 
IpServicelnstanceLifecycleManager 

(from Service Interfaces) 



^createServiceManagerO 
^destroyServiceManagerO 



Figure: Service Instance Lifecycle Manager Package Overview 
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«lnterface» 
IpSvcHeartBeatMgmt 



enableSvc HeartB eat 1 
disableSvcHeartBeatO 
change IntervalO 



«hterface» 
IpSvc Heart Beat 



pulseO 



«lnterface» 
^3 FvwH ear tB eat Mgmt 

enableHeartBeatO 
disableHeartBeatO 
changelnter\al() 



«hterface» 
iDFwHeartBeat 



pulseO 



«lnterface» 
lpS\c Load Manager 



queryS\cLoadReq() 

query LoadResO 

query Load Err{) 

loadLevelNotificationO 

suspendNotificationQ 

resumeNotificationO 

«new» createLoadLevelNotificationO 

«new» destroy LoadLe\«INotificationO 



«lnterface» 
IpFwLoadManager 



report Load 

query LoadReqO 

querySwD LoadResO 

querySvcLoadErrO 

CreateLoadLevelNotificationO 

destroyLoadLevelNotificationO 

suspendNotification{) 

resumeNotificationO 



«lnterface» 
IpSvcFaultManager 



activityTestResO 

s\cActivityTestReq() 

fwFaultReportlndQ 

fwFault Recovery IndO 

fwUna\ailablelnd() 

s\cUnavailablelnd() 

appUnavailablelndO 

genPaultStatsRecordResO 

activity Test Err() 

genFaultStatsRecordErrO 

genFaultStatsRecordReqO 



«lnterface» 
lpFwFaultl\yianager 



activityTestReqO 

sycActivityTestResO 

appUnavailablelndO 

genFaultStatsRecordReqO 

sy:;Unavailablelnd() 

svcActivityTestErrO 

genFaultStatsRecordResO 

genFaultStatsRecordErrO 



«lnterface» 
lpS\cOAM 



system DateTimeQueryO 



«lnterface» 
(dFwOAM 



system DateTimeQueryO 



Figure: Integrity l\/lanagement Package Overview 



«lnterface» 
IpSvc EventNot ifi cati on 

^rom Service Interfaces) 



l^reportNotificationO 
l^notificationTerminatedQ 

«uses» 



«lnterface» 
IpFwE vent Noti ficat ion 

(from Framework Interfaces) 



^createNotificationO 
l^estroyNotificationO 



Figure: Event Notification Package Overview 



ETSI 



3GPP TS 29.198-03 version 4.9.0 Release 4 



94 



ETSI TS 129 198-3 V4.9.0 (2004-06) 



8.3 Interface Classes 

8.3.1 Service Registration Interface Classes 

Before a service can be brokered (discovered, subscribed, accessed, etc.) by an enterprise, it has to be registered with 
the Framework. Services are registered against a particular service type. Therefore service types are created first, and 
then services corresponding to those types are accepted from the Service Suppliers for registration in the framework. 
The framework maintains a repository of service types and registered services. 

In order to register a new service in the framework, the service supplier must select a service type and the "property 
values" for the service. The service discovery functionality described in the previous clause enables the service supplier 
to obtain a list of all the service types supported by the framework and their associated sets of service property values. 

The Framework service registration-related interfaces are invoked by third party service supplier's administrative 
applications. They are described below. Note that these methods cannot be invoked until the authentication methods 
have been invoked successfully. 



8.3.1 .1 Interface Class IpFwServiceRegistration 

Inherits from: Iplnterface. 

The Service Registration interface provides the methods used for the registration of network SCFs at the framework. 
This interface and at least the methods registerService(), announceServiceAvailabilityO, unregisterService() and 
unannounceServiceO shall be implemented by a Framework. 

«lnterface» 
IpFwServiceRegistration 



registerService (servicelypeName : in TpServicelypeName, servicePropertyList : in TpServicePropertyList) 
: TpServicelD 

announceServiceAvailability (servicelD : in TpServicelD, servicelnstanceLifecycleManagerRef : in 
service_lifecycle::lpServicelnstanceLifecycleManagerRef) : void 

unregisterService (servicelD : in TpServicelD) : void 

describeService (servicelD : in TpServicelD) : TpServiceDescription 

unannounceService (servicelD : in TpServicelD) : void 



Method 

registerService () 

The registerServiceO operation is the means by which a service is registered in the Framework, for subsequent 
discovery by the enterprise applications. Registration can only succeed when the Service type of the service is known 
to the Framework (ServiceType is 'available'). A service-ID is returned to the service supplier when a service is 
registered in the Framework. When the service is not registered because the ServiceType is 'unavailable', a 
P_SERVICE_TYPE_UNAVAILABLE is raised. The service-ID is the handle with which the service supplier can 
identify the registered service when needed (e.g. for withdrawing it). The service-ID is only meaningful in the context 
of the Framework that generated it. 

Returns <serviceID> : This is the unique handle that is returned as a result of the successful completion of this 
operation. The Service Supplier can identify the registered service when attempting to access it via other operations 



ETSI 



3GPP TS 29.198-03 version 4.9.0 Release 4 



95 



ETSI TS 129 198-3 V4.9.0 (2004-06) 



such as unregisterServiceO, etc. Enterprise client applications are also returned this service-ID when attempting to 
discover a service of this type. 

Parameters 

serviceTypeName : in TpServiceTypeName 

The "serviceTypeName" parameter identifies the service type. If the string representation of the "type" does not obey 
the rules for identifiers, then an P_ILLEGAL_SERVICE_TYPE exception is raised. If the "type" is correct 
syntactically but the Framework is able to unambiguously determine that it is not a recognised service type, then a 
P_UNKNOWN_SERVICE_TYPE exception is raised. 

servicePropertyLis't : in TpServicePropertyList 

The "servicePropertyList" parameter is a list of property name and property value pairs. They describe the service being 
registered. This description typically covers behavioural, non-functional and non-computational aspects of the service. 
Service properties are marked "mandatory" or "readonly". These property mode attributes have the following semantics: 

a. mandatory - a service associated with this service type must provide an appropriate value for this property when 
registering. 

b. readonly - this modifier indicates that the property is optional, but that once given a value, subsequently it may 
not be modified. 

Specifying both modifiers indicates that a value must be provided and that subsequently it may not be modified. 
Examples of such properties are those which form part of a service agreement and hence cannot be modified by service 
suppliers during the life time of service. 

If the type of any of the property values is not the same as the declared type (declared in the service type), then a 
P_PROPERTY_TYPE_MISMATCH exception is raised. If an attempt is made to assign a dynamic property value to a 
readonly property, then the P_READONLY_DYNAMIC_PROPERTY exception is raised. If the "servicePropertyList" 
parameter omits any property declared in the service type with a mode of mandatory, then a 

P_MISSING_MANDATORY_PROPERTY exception is raised. If two or more properties with the same property name 
are included in this parameter, the P_DUPLICATE_PROPERTY_NAME exception is raised. 

Returns 
TpServicelD 

Raises 

TpCommonExceptions, P_ILLEGAL_SERVICE_ID, P_UNKNOWN_SERVICE_ID, 
P_PROPERTY_TYPE_MISMATCH, P_DUPLICATE_PROPERTY_NAME , 
P_ILLEGAL_SERVICE_TYPE , P_UNKNOWN_SERVICE_TYPE , 
P_MISSING_MANDATORY_PROPERTY, P_SERVICE_TYPE_UNAVAILABLE 



Method 

announceServiceAvailability ( ) 

The registerServiceO method described previously does not make the service discoverable. The 
announceServiceAvailabilityO method is invoked after the service is authenticated and its service instance lifecycle 
manager is instantiated at a particular interface. This method informs the framework of the availability of "service 
instance lifecycle manager" of the previously registered service, identified by its service ID, at a specific interface. After 
the receipt of this method, the framework makes the corresponding service discoverable. 

There exists a "service manager" instance per service instance. Each service implements the 

IpServicelnstanceLifecycleManager interface. The IpServicelnstanceLifecycleManager interface supports a method 
called the createServiceManager(application: in TpClientAppID, serviceProperties : in TpServicePropertyList, 
servicelnstancelD : in TpServicelnstancelD) : IpServiceRef. When the service agreement is signed for some servicelD 
(using signServiceAgreementO), the framework calls the createServiceManager() for this service, gets a 
serviceManager and returns this to the client application. 
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Parameters 

servicelD : in TpServicelD 

The service ID of the service that is being announced. If the string representation of the "servicelD" does not obey the 
rules for service identifiers, then an P_ILLEGAL_SERVICE_ID exception is raised. If the "servicelD" is legal but 
there is no service offer within the Framework with that ID, then an P_UNKNOWN_SERVICE_ID exception is raised. 

servicelnstanceLifecycleManagerRef : in 

service_lif ecycle : : IpServicelnstanceLif ecycleManagerRef 

The interface reference at which the service instance lifecycle manager of the previously registered service is available. 
Raises 

TpCommonExceptions, P_ILLEGAL_SERVICE_ID, P_UNKNOWN_SERVICE_ID, 
P_INVALID_INTERFACE_TYPE 



Method 

unregisterService () 

The unregisterServiceO operation is used by the service suppliers to remove a registered service from the Framework. 
The service is identified by the "service-ID" which was originally returned by the Framework in response to the 
registerServiceO operation. The service must be in the SCF Registered state. AH instances of the service will be 
deleted. 

Parameters 

servicelD : in TpServicelD 

The service to be withdrawn is identified by the "servicelD" parameter which was originally returned by the 
registerServiceO operation. If the string representation of the "servicelD" does not obey the rules for service 
identifiers, then an P_ILLEGAL_SERVICE_ID exception is raised. If the "servicelD" is legal but there is no service 
offer within the Framework with that ID, then an P_UNKNOWN_SERVICE_ID exception is raised. 

Raises 

TpCommonExceptions, P_ILLEGAL_SERVICE_ID, P_UNKNOWN_SERVICE_ID 



Method 

describeService () 

The describeServiceO operation returns the information about a service that is registered in the framework. It 
comprises, the "type" of the service , and the "properties" that describe this service. The service is identified by the 
"service-ID" parameter which was originally returned by the registerServiceO operation. 

The SCS may register various versions of the same SCF, each with a different description (more or less restrictive, for 
example), and each getting a different servicelD assigned. 

Returns <serviceDescription> : This consists of the information about an offered service that is held by the Framework. 
It comprises the "type" of the service , and the properties that describe this service. 
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Parameters 

servicelD : in TpServicelD 

The service to be described is identified by the "servicelD" parameter which was originally returned by the 
registerServiceO operation. If the string representation of the "servicelD" does not obey the rules for object identifiers, 
then an P_ILLEGAL_SERVICE_ID exception is raised. If the "servicelD" is legal but there is no service offer within 
the Framework with that ID, then a P_UNKNOWN_SERVICE_ID exception is raised. 

Returns 

TpServiceDescrip'tion 

Raises 

TpCommonExceptions, P_ILLEGAL_SERVICE_ID, P_UNKNOWN_SERVICE_ID 



Method 

unannounceService ( ) 

This method results in the service no longer being discoverable by applications. It is, however, still registered and the 
service ID is still associated with it. Applications currently using the service can continue to use the service but no new 
applications should be able to start using the service. Also, all unused service tokens relating to the service will be 
expired. This will prevent anyone who has already performed a selectService() but not yet performed the 
signServiceAgreementO from being able to obtain a new instance of the service. 

Parameters 

servicelD : in TpServicelD 

The service ID of the service that is being unannounced. If the string representation of the "servicelD" does not obey 
the rules for service identifiers, then an P_ILLEGAL_SERVICE_ID exception is raised. If the "servicelD" is legal but 
there is no service offer within the Framework with that ID, then an P_UNKNOWN_SERVICE_ID exception is raised. 

Raises 

TpCommonExceptions, P_ILLEGAL_SERVICE_ID, P_UNKNOWN_SERVICE_ID 



The IpServicelnstanceLifecycleManager interface allows the framework to get access to a service manager interface of 
a service. It is used during the signServiceAgreement, in order to return a service manager interface reference to the 
application. Each service has a service manager interface that is the initial point of contact for the service. E.g., the 
generic call control service uses the IpCaUControManager interface. 



8.3.2.1 Interface Class IpServicelnstanceLlfecycleManager 

Inherits from: Iplnterface. 

The IpServicelnstanceLifecycleManager interface allows the Framework to create and destroy Service Manager 
Instances. 

This interface and the createServiceManagerQ and destroyServiceManagerQ methods shall be implemented by a 
Service. 



8.3.2 



Service Instance Lifecycle Manager Interface Classes 
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«lnterface» 
IpServicelnstanceLifecycleManager 



createServiceManager (application : in TpClientAppID, serviceProperties : in TpServicePropertyList, 
servicelnstancelD : in TpServicelnstancelD) : IpServiceRef 

destroyServiceManager (servicelnstance : in TpServicelnstancelD) : void 



Method 

createServiceManager () 

This method returns a new service manager interface reference for the specified application. The service instance will 
be configured for the client application using the properties agreed in the service level agreement. 

Returns <serviceManager> : Specifies the service manager interface reference for the specified application ID. 
Parameters 

application : in TpClientAppID 

Specifies the application for which the service manager interface is requested. 
serviceProperties : in TpServicePropertyList 

Specifies the service properties and their values that are to be used to configure the service instance. These properties 
form a part of the service level agreement. An example of these properties is a list of methods that the client application 
is allowed to invoke on the service interfaces. 

servicelnstancelD : in TpServicelnstancelD 

Specifies the Service Instance ID that the new Service Manager is to be identified by. 

Returns 

IpServiceRef 

Raises 

TpCommonExceptions , P_INVALID_PROPERTY 



Method 

destroyServiceManager ( ) 

This method destroys an existing service manager interface reference. This will result in the client application being 
unable to use the service manager any more. 

Parameters 

servicelnstance : in TpServicelnstancelD 

Identifies the Service Instance to be destroyed. 
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Raises 

TpCommonExceptions 



8.3.3 Service Discovery Interface Classes 

This API complements the Service Registration functionality described in another clause. 

Before a service can be registered in the framework, the service supplier must know what "types" of services the 
Framework supports and what service "properties" are applicable to each service type. The "listServiceTypeO" method 
returns a list of all "service types" that are currently supported by the framework and the "describeServiceTypeO" 
method returns a description of each service type. The description of service type includes the "service-specific 
properties" that are applicable to each service type. Then the service supplier can retrieve a specific set of registered 
services that both belong to a given type and possess a specific set of "property values", by using the 
"discoverServiceO" method. 

Additionally the service supplier can retrieve a list of all registered services, without regard to type or property values, 
by using the "listRegisteredServicesO" method. However the scope of the list will depend upon the framework 
implementation; e.g. a service supplier may only be permitted to retrieve a list of services that the service supplier has 
previously registered. 



8.3.3.1 Interface Class IpFwServiceDlscovery 

Inherits from: Iplnterface. 

This interface shall be implemented by a Framework with as a minimum requirement the listServiceTypes(), 
describeServiceTypeO and discoverService() methods. 



«lnterface» 
IpFwServiceDiscovery 



listServicelypes () : TpServicelypeNameList 

describeServicelype (name : in TpServicelypeName) : TpServicelypeDescription 

discoverService (serviceTypeName : in TpServicelypeName, desiredPropertyList : in 
TpServicePropertyList, max : in Tplnt32) : TpServiceList 

listRegisteredServices () : TpServiceList 



Method 

listServiceTypes () 

This operation returns the names of all service types that are in the repository. The details of the service types can then 
be obtained using the describeServiceTypeO method. 

Returns <listTypes> : The names of the requested service types. 
Parameters 

No Parameters were identified for this method 
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Returns 

TpServiceTypeNameLis't 

Raises 

TpCommonExcep'tions 



Method 

describeServiceType ( ) 

This operation lets the caller obtain the details for a particular service type. 

Returns <serviceTypeDescription> : The description of the specified service type. The description provides information 
about: the service properties associated with this service type: i.e. a list of service property {name, mode and type} 
tuples, the names of the super types of this service type, and whether the service type is currently available or 
unavailable. 



Parameters 

name : in TpServiceTypeName 

The name of the service type to be described. If the "name" is malformed, then the P_ILLEGAL_SERVICE_TYPE 
exception is raised. If the "name" does not exist in the repository, then the P_UNKNOWN_SERVICE_TYPE 
exception is raised. 



Returns 

TpServiceTypeDescription 

Raises 

TpCommonExceptions, P_ILLEGAL_SERVICE_TYPE, P_UNKNOWN_SERVICE_TYPE 



Method 

discoverService () 

The discoverService operation is the means by which the service suppUer can retrieve a specific set of registered 
services that both belong to a given type and possess a specific set of "property values". The service supplier passes in 
a list of desired service properties to describe the service it is looking for, in the form of attribute/value pairs for the 
service properties. The service supplier also specifies the maximum number of matched responses it is wilhng to accept. 
The framework must not return more matches than the specified maximum, but it is up to the discretion of the 
Framework implementation to choose to return less than the specified maximum. The discoverService() operation 
returns a servicelD/Property pair list for those services that match the desired service property Ust that the service 
suppher provided. 

Returns <serviceList> : This parameter gives a list of matching services. Each service is characterised by its service ID 
and a list of service properties {name and value list} associated with the service. 
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Parameters 

serviceTypeName : in TpServiceTypeName 

The name of the required service type. If the string representation of the "type" does not obey the rules for service type 
identifiers, then the P_ILLEGAL_SERVICE_TYPE exception is raised. If the "type" is correct syntactically but is not 
recognised as a service type within the Framework, then the P_UNKNOWN_SERVICE_TYPE exception is raised. The 
framework may return a service of a subtype of the "type" requested. A service sub-type can be described by the 
properties of its supertypes. 

desiredPropertyList : in TpServicePropertyList 

The "desiredPropertyList" parameter is a list of service properties {name and value hst} that the required services 
should satisfy. These properties deal with the non-functional and non-computational aspects of the desired service. The 
property values in the desired property list must be logically interpreted as "minimum", "maximum", etc. by the 
framework (due to the absence of a Boolean constraint expression for the specification of the service criterion). It is 
suggested that, at the time of service registration, each property value be specified as an appropriate range of values, so 
that desired property values can specify an "enclosing" range of values to help in the selection of desired services. 

max : in Tpln't32 

The "max" parameter states the maximum number of services that are to be returned in the "serviceList" result. 
Returns 

TpServiceList 

Raises 

TpCommonExceptions, P_ILLEGAL_SERVICE_TYPE, P_UNKNOWN_SERVICE_TYPE, 
P_INVALID_PROPERTY 



Method 

listRegisteredServices ( ) 

Returns a list of services so far registered in the framework. 

Returns <serviceList> : The "serviceList" parameter returns a list of registered services. Each service is characterised 
by its service ID and a list of service properties {name and value list} associated with the service. 

Parameters 

No Parameters were identified for this method 
Returns 

TpServiceList 

Raises 

TpCommonExcep'tions 

8.3.4 Integrity Management Interface Classes 

8.3.4.1 Interface Class IpFwFaultManager 

Inherits from: Iplnterface. 
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This interface is used by the service instance to inform the framework of events which affect the integrity of the API, 
and request fauh management status information from the framework. The fauh manager operations do not exchange 
callback interfaces as it is assumed that the service instance has supplied its Fault Management callback interface at the 
time it obtains the Framework's Fault Management interface, by use of the obtainlnterfaceWithCallback operation on 
the IpAccess interface. 

If the IpFwFaultManager interface is implemented by a Framework, at least one of these methods shall be 
implemented. If the Framework is capable of invoking the IpSvcFaultManager.svcActivityTestReqO method, it shall 
implement svcActivityTestRes() and svcActivityTestErr() in this interface. If the Framework is capable of invoking 
IpSvcFaultManager.genFaultStatsRecordReqO, it shall implement genFaultStatsRecordRes() and 
genFaultStatsRecordErrO in this interface. 

«lnterface» 
IpFwFaultManager 



activityTestReq (activityTestID : in TpActivityTestID, testSubject : in TpSubjectType) : void 
svcActivityTestRes (activityTestID : in TpActivityTestID, activityTestResult : in TpActivityTestRes) : void 
appUnavailableInd () : void 

genFaultStatsRecordReq (timePeriod : in TpTimelnterval, recordSubject : in TpSubjectType) : void 
svcUnavailableInd (reason : in TpSvcUnavailReason) : void 
svcActivityTestErr (activityTestID : in TpActivityTestID) : void 

genFaultStatsRecordRes (faultStatistics : in TpFaultStatsRecord, servicelDs : in TpServicelDList) : void 

genFaultStatsRecordErr (faultStatisticsError : in TpFaultStatisticsError, servicelDs : in TpServicelDList) : 
void 



Method 

activityTestReq ( ) 

The service instance invokes this method to test that the framework or the client application is operational. On receipt of 
this request, the framework must carry out a test on itself or on the application, to check that it is operating correctly. 
The framework reports the test result by invoking the activity TestRes method on the IpSvcFaultManager interface. 

Parameters 

activityTestID : in TpActivityTestID 

The identifier provided by the service instance to correlate the response (when it arrives) with this request. 

testSubject : in TpSubjectType 

Identifies the subject for testing (framework or client application). 

Raises 

TpCornmonExceptions 
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Method 

svcActivityTestRes () 

The service instance uses this method to return the result of a framework-requested activity test. 
Parameters 

activityTestID : in TpActivityTestID 

Used by the framework to correlate this response (when it arrives) with the original request. 

activityTestResult : in TpActivityTestRes 

The result of the activity test. 

Raises 

TpCommonExceptions , P_INVALID_ACTIVITY_TEST_ID 



Method 

appUnavailableInd ( ) 

This method is used by the service instance to inform the framework that the client application is not responding. On 
receipt of this indication, the framework must act to inform the client application that it should cease use of this service 
instance. 

Parameters 

No Parameters were identified for this method 
Raises 

TpCommonExcep'tions 



Method 

genFaultStatsRecordReq ( ) 

This method is used by the service instance to sohcit fault statistics from the framework. On receipt of this request, the 
framework must produce a fault statistics record, for the framework or for the application during the specified time 
interval, which is returned to the service instance using the genFaultStatsRecordRes operation on the 
IpSvcFaultManager interface. 

Parameters 

timePeriod : in TpTimelnterval 

The period over which the fault statistics are to be generated. Supplying both a start time and stop time as empty strings 
leaves the time period to the discretion of the framework. 

recordSvibject : in TpSvibjectType 

Specifies the subject to be included in the general fault statistics record (framework or appUcation). 
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Raises 

TpCommonExcep'tions 



Method 

svcUnavailableInd ( ) 

This method is used by the service instance to inform the framework that it is about to become unavailable for use. The 
framework should inform the cUent application that is currently using this service instance that it is unavailable for use 
(via the svcUnavailableInd method on the IpAppFaultManager interface). 

Parameters 

reason : in TpSvcUnavailReason 

Identifies the reason for the service instance's unavailability. 

Raises 

TpCommonExcep'tions 



Method 

svcActivityTestErr ( ) 

The service instance uses this method to indicate that an error occurred during a framework-requested activity test. 
Parameters 

activityTestID : in TpActivityTestID 

Used by the framework to correlate this response (when it arrives) with the original request. 
Raises 

TpCommonExceptions , P_INVALID_ACTIVITY_TEST_ID 



Method 

genFaultStatsRecordRes () 

This method is used by the service to provide fault statistics to the framework in response to a genFaultStatsRecordReq 
method invocation on the IpSvcFaultManager interface. 

Parameters 

faultStatistics : in TpFaultStatsRecord 

The fault statistics record. 
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servicelDs : in TpServicelDList 

Specifies the services that are included in the general fault statistics record. The servicelDs parameter is not allowed to 
be an empty hst. 

Raises 

TpCommonExcep'tions 



Method 

genFaultStatsRecordErr ( ) 

This method is used by the service to indicate an error fulfilling the request to provide fault statistics, in response to a 
genFaultStatsRecordReq method invocation on the IpSvcFaultManager interface. 

Parameters 

f aultStatisticsError : in TpFaultStatisticsError 

The fault statistics error. 

servicelDs : in TpServicelDList 

Specifies the services that were included in the general fault statistics record request. The servicelDs parameter is not 
allowed to be an empty list. 

Raises 

TpCommonExcep'tions 



8.3.4.2 Interface Class IpSvcFaultManager 

Inherits from: Iplnterface. 

This interface is used to inform the service instance of events that affect the integrity of the Framework, Service or 
Client Application. The Framework will invoke methods on the Fault Management Service Interface that is specified 
when the service instance obtains the Fault Management Framework interface: i.e. by use of the 
obtainlnterfaceWithCallback operation on the IpAccess interface. 

If the IpSvcFaultManager interface is implemented by a Service, at least one of these methods shall be implemented. 
If the Service is capable of invoking the IpFwFaultManager.activityTestReqO method, it shall implement 
activityTestResO and activity TestErr() in this interface. If the Service is capable of invoking 
IpFwFaultManager.genFaultStatsRecordReqO, it shall implement genFaultStatsRecordRes() and 
genFaultStatsRecordErrO in this interface. 
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«lnterface» 
IpSvcFaultManager 



activityTestRes (activityTestID : in TpActivityTestID, activityTestResult : in TpActivityTestRes) : void 

svcActivityTestReq (activityTestID : in TpActivityTestID) : void 

fwFaultReportInd (fault : in TplnterfaceFault) : void 

fwFaultRecoveryInd (fault : in TplnterfaceFault) : void 

fwUnavailableInd (reason : in TpFwUnavailReason) : void 

svcUnavailableInd () : void 

appUnavailableInd () : void 

genFaultStatsRecordRes (faultStati sties : in TpFaultStatsRecord, recordSubject : in TpSubjectType) : void 
activityTestErr (activityTestID : in TpActivityTestID) : void 

genFaultStatsRecordErr (faultStatisticsError : in TpFaultStatisticsError, recordSubject : in TpSubjectType) : 
void 

genFaultStatsRecordReq (timePeriod : in TpTimelnterval, servicelDs : in TpServicelDList) : void 



Method 

activityTestRes () 

The framework uses this method to return the result of a service-requested activity test. 
Parameters 

activityTestID : in TpActivityTestID 

Used by the service to correlate this response (when it arrives) with the original request. 

activityTestResult : in TpActivityTestRes 

The result of the activity test. 

Raises 

TpCommonExceptions , P_INVALID_ACTIVITY_TEST_ID 



Method 

svcActivityTestReq ( ) 

The framework invokes this method to test that the service instance is operational. On receipt of this request, the service 
instance must carry out a test on itself, to check that it is operating correctly. The service instance reports the test result 
by invoking the svcActivityTestRes method on the IpFwFaultManager interface. 
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Parameters 

activityTestID : in TpActivityTestID 

The identifier provided by the framework to correlate the response (when it arrives) with this request. 
Raises 

TpCommonExcep'tions 



Method 

f wFaultReportInd ( ) 

The framework invokes this method to notify the service instance of a failure within the framework. The service 
instance must not continue to use the framework until it has recovered (as indicated by a fwFaultRecoveryInd). 

Parameters 

fault : in TpInterfaceFaul't 

Specifies the fault that has been detected by the framework. 

Raises 

TpCommonExceptions 



Method 

fwFaultRecoveryInd ( ) 

The framework invokes this method to notify the service instance that a previously reported fault has been rectified. 
The service instance may then resume using the framework. 

Parameters 

fault : in Tplnterf aceFault 

Specifies the fault from which the framework has recovered. 



Raises 

TpCommonExcep'tions 



Method 

f wUnavailableInd ( ) 

The framework invokes this method to inform the service instance that it is no longer available. 
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Parameters 

reason : in TpFwUnavailReason 

Identifies the reason why the framework is no longer available 

Raises 

TpCommonExcep'tions 



Method 

svcUnavailableInd ( ) 

The framework invokes this method to inform the service instance that the client application has reported that it can no 
longer use the service instance (either due to a failure in the client application or in the service instance itself). The 
service should assume that the client application is leaving the service session and the service should act accordingly to 
terminate the session from its own end too. 

Parameters 

No Parameters were identified for this method 
Raises 

TpCommonExcep'tions 



Method 

appUnavailableInd ( ) 

The framework invokes this method to inform the service instance that the client application is ceasing its current use of 
the service. This may be a result of the appUcation reporting a failure. Alternatively, the framework may have detected 
that the apphcation has failed: e.g. non-response from an activity test, failure to return heartbeats. 

Parameters 

No Parameters were identified for this method 

Raises 

TpCommonExcep t i on s 



Method 

genFaultStatsRecordRes () 

This method is used by the framework to provide fault statistics to a service instance in response to a 
genFaultStatsRecordReq method invocation on the IpFwFaultManager interface. 
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Parameters 

faultStatistics : in TpFaultStatsRecord 

The fault statistics record. 

recordSvibject : in TpSvibjectType 

Specifies the entity (framework or apphcation) whose fault statistics record has been provided. 
Raises 

TpCommonExcep'tions 



Method 

activityTestErr ( ) 

The framework uses this method to indicate that an error occurred during a service-requested activity test. 
Parameters 

activityTestID : in TpActivityTestID 

Used by the service instance to correlate this response (when it arrives) with the original request. 
Raises 

TpCommonExcept ions , P_INVALID_ACTIVITY_TEST_ID 



Method 

genFaultStatsRecordErr () 

This method is used by the framework to indicate an error fulfilling the request to provide fault statistics, in response to 
a genFaultStatsRecordReq method invocation on the IpFwFaultManager interface. 

Parameters 

f aultStatisticsError : in TpFaultS'tatis'ticsError 

The fault statistics error. 

recordSvibject : in TpSvibjectType 

Specifies the entity (framework or apphcation) whose fault statistics record was requested. 
Raises 

TpCommonExcep'tions 



Method 

genFaultStatsRecordReq ( ) 

This method is used by the framework to sohcit fault statistics from the service, for example when the framework was 
asked for these statistics by the client apphcation using the genFaultStatsRecordReq operation on the IpFaultManager 
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interface. On receipt of this request the service must produce a fauh statistics record, for either the framework or for the 
cHent's instances of the specified services during the specified time interval, which is returned to the framework using 
the genFauhStatsRecordRes operation on the IpFwFauhManager interface. If the framework does not have access to a 
service instance with the specified servicelD, the P_UNAUTHORISED_PARAMETER_VALUE exception shall be 
thrown. The extralnformation field of the exception shall contain the corresponding servicelD. 

Parameters 

timePeriod : in TpTime Interval 

The period over which the fault statistics are to be generated. Supplying both a start time and stop time as empty strings 
leaves the time period to the discretion of the service. 

servicelDs : in TpServicelDList 

Specifies the services to be included in the general fault statistics record. This parameter is not allowed to be an empty 
list. 

Raises 

TpCommonExceptions , P_INVALID_SERVICE_ID , P_UNAUTHORISED_PARAMETER_VALUE 

8.3.4.3 Interface Class IpFwHeartBeatMgmt 

Inherits from: Iplnterface. 

This interface allows the initialisation of a heartbeat supervision of the framework by a service instance. If the 
IpFwHeartBeatMgmt interface is implemented by a Framework, as a minimum enableHeartBeatQ and 
disableHeartBeatO shall be implemented. 

«lnterface» 
IpFwHeartBeatMgmt 



enableHeartBeat (interval : in Tplnt32, svclnterface : in IpSvcHeartBeatRef) : void 
disableHeartBeat () : void 
changelnterval (interval : in Tplnt32) : void 



Method 

enableHeartBeat ( ) 

With this method, the service instance instructs the framework to begin sending its heartbeat to the specified interface at 
the specified interval. 

Parameters 

interval : in Tplnt32 

The time interval in milliseconds between the heartbeats. 

svclnterface : in IpSvcHeartBeatRef 

This parameter refers to the callback interface the heartbeat is calling. 
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Raises 

TpCommonExcept ions , P_INVALID_INTERFACE_TYPE 



Method 

disableHeartBeat () 

Instructs the framework to cease the sending of its heartbeat. 
Parameters 

No Parameters were identified for this method 
Raises 

TpCommonExcept i on s 



Method 

changelnterval ( ) 

Allows the administrative change of the heartbeat interval. 

Parameters 

interval : in Tplnt32 

The time interval in milliseconds between the heartbeats. 

Raises 

TpCommonExceptions 



8.3.4.4 Interface Class IpFwHeartBeat 

Inherits from: Iplnterface. 

The service side framework heartbeat interface is used by the service instance to send the framework its heartbeat. If a 
Framework is capable of invoking IpSvcHeartBeatMgmt.enableHeartBeat(), it shall implement IpFwHeartBeat and the 
pulseO method. 



ETSI 



3GPP TS 29.198-03 version 4.9.0 Release 4 



112 



ETSI TS 129 198-3 V4.9.0 (2004-06) 



«lnterface» 
IpFwHeartBeat 



pulse : void 



Method 
pulse 

The service instance uses this method to send its heartbeat to the framework. The framework will be expecting a pulse 
at the end of every interval specified in the parameter to the IpSvcHeartBeatMgmt.enableSvcHeartbeat() method. If the 
pulse() is not received within the specified interval, then the service instance can be deemed to have failed the heartbeat. 

Parameters 

No Parameters were identified for this method 
Raises 

TpCornmonExcep t i on s 



8.3.4.5 Interface Class IpSvcHeartBeatMgmt 

Inherits from: Iplnterface. 

This interface allows the initialisation of a heartbeat supervision of the service instance by the framework. If the 
IpSvcHeartBeatMgmt interface is implemented by a Service, as a minimum enableHeartBeat() and disableHeartBeat() 
shall be implemented. 



«lnterface» 
IpSvcHeartBeatMgmt 



enableSvcHeartBeat (interval : in Tplnt32, fwlnterface : in IpFwHeartBeatRef) : void 
disableSvcHeartBeat () : void 
changelnterval (interval : in Tplnt32) : void 



Method 

enableSvcHeartBeat ( ) 

With this method, the framework instructs the service instance to begin sending its heartbeat to the specified interface at 
the specified interval. 
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Parameters 

interval : in Tpln't32 

The time interval in milliseconds between the heartbeats. 

fwlnterface : in IpFwHeartBeatRef 

This parameter refers to the callback interface the heartbeat is calUng. 

Raises 

TpCommonExcept ions , P_INVALID_INTERFACE_TYPE 



Method 

disableSvcHeartBeat () 

Instructs the service instance to cease the sending of its heartbeat. 

Parameters 

No Parameters were identified for this method 
Raises 

TpCommonExcep'tions 



Method 

changelnterval ( ) 

Allows the administrative change of the heartbeat interval. 
Parameters 

interval : in Tplnt32 

The time interval in milliseconds between the heartbeats. 

Raises 

TpCommonExceptions 



8.3.4.6 Interface Class IpSvcHeartBeat 

Inherits from: Iplnterface. 

The service heartbeat interface is used by the framework to send the service instance its heartbeat. If a Service is 
capable of invoking IpFwHeartBeatMgmt.enableHeartBeat(), it shall implement IpSvcHeartBeat and the pulse() 
method. 
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«lnterface» 
IpSvcHeartBeat 



pulse : void 



Method 
pulse ( ) 

The framework uses this method to send its heartbeat to the service instance. The service will be expecting a pulse at 
the end of every interval specified in the parameter to the IpFwHeartBeatMgmt.enableHeartbeat() method. If the 
pulse() is not received within the specified interval, then the framework can be deemed to have failed the heartbeat. 

Parameters 

No Parameters were identified for this method 
Raises 

TpCornmonExcep t i on s 



8.3.4.7 Interface Class IpFwLoadManager 

Inherits from; Iplnterface. 

The framework API should allow the load to be distributed across multiple machines and across multiple component 
processes, according to a load management policy. The separation of the load management mechanism and load 
management policy ensures the flexibility of the load management services. The load management policy identifies 
what load management rules the framework should follow for the specific service. It might specify what action the 
framework should take as the congestion level changes. For example, some real-time critical applications will want to 
make sure continuous service is maintained, below a given congestion level, at all costs, whereas other services will be 
satisfied with disconnecting and trying again later if the congestion level rises. Clearly, the load management policy is 
related to the QoS level to which the application is subscribed. The framework load management function is represented 
by the IpFwLoadManager interface. To handle responses and reports, the service developer must implement the 
IpSvcLoadManager interface to provide the callback mechanism. 

If the IpFwLoadManager interface is implemented by a Framework, at least one of the methods shall be 
implemented as a minimum requirement. If load level notifications are supported, the createLoadLevelNotification() 
and destroyLoadLevelNotificationO methods shall be implemented. If suspendNotification() is implemented, then 
resumeNotificationO shall be implemented also. If a Framework is capable of invoking the 

IpSvcLoadManager.querySvcLoadReqO method, then it shall implement querySvcLoadRes() and querySvcLoadErr() 
methods in this interface. 
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«lnterface» 
IpFwLoadManager 



reportLoad (loadLevel : in TpLoadLevel) : void 

queryLoadReq (querySubject : in TpSubjectType, timelnterval : in TpTimelnterval) : void 
querySvcLoadRes (loadStatistics : in TpLoadStatisticList) : void 
querySvcLoadErr (loadStatisticError : in TpLoadStatisticError) : void 
createLoadLevelNotification (notificationSubject : in TpSubjectType) : void 
destroyLoadLevelNotification (notificationSubject : in TpSubjectType) : void 
suspendNotification (notificationSubject : in TpSubjectType) : void 
resumeNotification (notificationSubject : in TpSubjectType) : void 



Method 

reportLoad ( ) 

The service instance uses this method to report its current load level (0,1, or 2) to the framework: e.g. when the load 
level on the service instance has changed. In addition this method shall be called by the service instance in order to 
report current load status, when load notifications are first requested, or resumed after suspension. 

At level load, the service instance is performing within its load specifications (i.e. it is not congested or overloaded). 
At level 1 load, the service instance is overloaded. At level 2 load, the service instance is severely overloaded. 

Parameters 

loadLevel : in TpLoadLevel 

Specifies the service instance's load level. 

Raises 

TpCommonExceptions 



Method 

queryLoadReq ( ) 

The service instance uses this method to request the framework to provide load statistics records for the framework or 
for the application that uses the service instance. 

Parameters 

querySubject : in TpSubjectType 

Specifies the entity (framework or application) for which load statistics records should be reported. 
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timelnterval : in TpTime Interval 

Specifies the time interval for which load statistics records should be reported. 
Raises 

TpCommonExcep'tions 



Method 

querySvcLoadRes ( ) 

The service instance uses this method to send load statistic records back to the fi^amework that requested the 
information; i.e. in response to an invocation of the querySvcLoadReq method on the IpSvcLoadManager interface. 

Parameters 

loadStatistics : in TpLoadStatisticList 

Specifies the service-supplied load statistics. 

Raises 

TpCommonExceptions 



Method 

querySvcLoadErr ( ) 

The service instance uses this method to return an error response to the framework that requested the service instance's 
load statistics information, when the service instance is unsuccessful in obtaining any load statistic records; i.e. in 
response to an invocation of the querySvcLoadReq method on the IpSvcLoadManager interface. 

Parameters 

loadSta'tis'ticError : in TpLoadS'tatisticError 

Specifies the error code associated with the failed attempt to retrieve the service instance's load statistics. 



Raises 

TpCommonExceptions 



Method 

createLoadLevelNotif ication 

The service instance uses this method to register to receive notifications of load level changes associated with the 
framework or with the application that uses the service instance. Upon receipt of this method the framework shall 
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inform the service instance of the current framework or application load using the loadLevelNotification method on the 
corresponding IpSvcLoadManager. 

Parameters 

notif icationSvibject : in TpSvibjectType 

Specifies the entity (framework or application) for which load level changes should be reported. 

Raises 

TpCommonExcep t i on s 



Method 

destroyLoadLevelNotif ication ( ) 

The service instance uses this method to unregister for notifications of load level changes associated with the 
framework or with the application that uses the service instance. 

Parameters 

notificationSiibject : in TpSiibjectType 

Specifies the entity (framework or application) for which load level changes should no longer be reported. 
Raises 

TpCommonExcep'tions 



Method 

suspendNotif ication ( ) 

The service instance uses this method to request the framework to suspend sending it notifications associated with the 
framework or with the application that uses the service instance; e.g. while the service instance handles a temporary 
overload condition. 

Parameters 

notificationSiibject : in TpSub jectType 

Specifies the entity (framework or appUcation) for which the sending of notifications by the framework should be 
suspended. 

Raises 

TpCommonExcep'tions 
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Method 

resumeNotif ication ( ) 

The service instance uses this method to request the framework to resume sending it notifications associated with the 
fi-amework or with the application that uses the service instance; e.g. after a period of suspension during which the 
service instance handled a temporary overload condition. Upon receipt of this method the framework shall inform the 
service instance of the current framework or application load using the loadLeveLNotification method on the 
corresponding IpSvcLoadManager. 

Parameters 

notif icationSub ject : in TpSub jectType 

Specifies the entity (framework or application) for which the sending of notifications of load level changes by the 
framework should be resumed. 

Raises 

TpCommonExceptions 

8.3.4.8 Interface Class IpSvcLoadManager 

Inherits from: Iplnterface. 

The service developer supplies the load manager service interface to handle requests, reports and other responses from 
the framework load manager function. The service instance supplies the identity of its callback interface at the time it 
obtains the framework's load manager interface, by use of the obtainInterfaceWithCallback() method on the IpAccess 
interface. 

If the IpSvcLoadManager interface is implemented by a Service, at least one of the methods shall be implemented as 
a minimum requirement. If load level notifications are supported, then loadLevelNotification() shall be implemented. If 
a the Service is capable of invoking the IpFwLoadManager.queryLoadReqO method, then it shall implement 
queryLoadResO and queryLoadErr() methods in this interface. 

«lnterface» 
IpSvcLoadManager 



querySvcLoadReq (timelnterval : in TpTimelnterval) : void 
queryLoadRes (loadStatistics : in TpLoadStatisticList) : void 
queryLoadErr (loadStatisticsError : in TpLoadStatisticError) : void 
loadLevelNotification (loadStatistics : in TpLoadStatisticList) : void 
suspendNotification () : void 
resumeNotification () : void 
«new» createLoadLevelNotification () : void 
«new» destroyLoadLevelNotification () : void 



Method 

querySvcLoadReq ( ) 

The framework uses this method to request the service instance to provide its load statistic records. 
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Parameters 

timeln'terval : in TpTimelnterval 

Specifies the time interval for which load statistic records should be reported. 
Raises 

TpCommonExcep'tions 



Method 

query LoadRes ( ) 

The framework uses this method to send load statistic records back to the service instance that requested the 
information; i.e. in response to an invocation of the queryLoadReq method on the IpFwLoadManager interface. 

Parameters 

loadStatistics : in TpLoadStatisticList 

Specifies the framework- supplied load statistics 

Raises 

TpCommonExceptions 



Method 

query LoadErr ( ) 

The framework uses this method to return an error response to the service that requested the framework's load statistics 

information, when the framework is unsuccessful in obtaining any load statistic records; i.e. in response to an 
invocation of the queryLoadReq method on the IpFwLoadManager interface. 

Parameters 

loadS'tatis'ticsError : in TpLoadStatis'ticError 

Specifies the error code associated with the failed attempt to retrieve the framework's load statistics. 



Raises 

TpCommonExceptions 
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Method 

loadLevelNotif ication ( ) 

Upon detecting load condition change, (e.g. load level changing from to 1, to 2, 1 to 0, for the application or 
framework which has been registered for load level notifications) this method is invoked on the SCF. In addition this 
method shall be invoked on the SCF in order to provide a notification of current load status, when load notifications are 
first requested, or resumed after suspension. 

Parameters 

loadStatistics : in TpLoadStatisticList 

Specifies the framework- supplied load statistics, which include the load level chaiige(s). 
Raises 

TpCommonExcep'tions 



Method 

suspendNotif ication ( ) 

The framework uses this method to request the service instance to suspend sending it any notifications: e.g. while the 
framework handles a temporary overload condition. 

Parameters 

No Parameters were identified for this method 
Raises 

TpCommonExcep'tions 



Method 

resumeNot if ication ( ) 

The framework uses this method to request the service instance to resume sending it notifications: e.g. after a period of 
suspension during which the framework handled a temporary overload condition. Upon receipt of this method the 
service instance shall inform the framework of the current load using the reportLoad method on the corresponding 
IpFwLoadManager. 

Parameters 

No Parameters were identified for this method 
Raises 

TpCommonExcep'tions 
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Method 

«new» createLoadLevelNotif ication () 

The framework uses this method to register to receive notifications of load level changes associated with the service 
instance. Upon receipt of this method the service instance shall inform the framework of the current load using the 
reportLoad method on the corresponding IpFwLoadManager. 

Parameters 

No Parameters were identified for this method 
Raises 

TpCommonExceptions 



Method 

«new» destroyLoadLevelNotif ication () 

The framework uses this method to unregister for notifications of load level changes associated with the service 
instance. 

Parameters 

No Parameters were identified for this method 
Raises 

TpCommonExceptions 

8.3.4.9 Interface Class IpFwOAM 

Inherits from: Iplnterface. 

The OAM interface is used to query the system date and time. The service and the framework can synchronise the date 
and time to a certain extent. Accurate time synchronisation is outside the scope of this API. This interface and the 
systemDateTimeQueryO method are optional. 

«lnterface» 
IpFwOAM 



systemDateTimeQuery (clientDateAndTime : in TpDateAndTime) : TpDateAndTime 



Method 

systemDateTimeQuery ( ) 

This method is used to query the system date and time. The client (service) passes in its own date and time to the 
framework. The framework responds with the system date and time. 

Returns <systemDateAndTime> : This is the system date and time of the framework. 
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Parameters 

clientDateAndTime : in TpDateAndTime 

This is the date and time of the client (service). The error code P_INVALID_DATE_TIME_FORMAT is returned if the 
format of the parameter is invalid. 

Returns 

TpDateAndTime 

Raises 

TpCommonExceptions , P_INVALID_TIME_AND_DATE_FORMAT 

8.3.4.10 Interface Class IpSvcOAM 

Inherits from: Iplnterface. 

This interface and the systemDateTimeQueryO method are optional. 

«lnterface» 
IpSvcOAM 



systemDateTimeQuery (system DateAndTime : in TpDateAndTime) : TpDateAndTime 



Method 

systemDateTimeQuery ( ) 

This method is used by the framework to send the system date and time to the service. The service responds with its 
own date and time. 

Returns <clientDateAndTime> : This is the date and time of the client (service). 
Parameters 

systemDateAndTime : in TpDateAndTime 

This is the system date and time of the framework. The error code P_INVALID_DATE_TIME_FORMAT is returned 
if the format of the parameter is invalid. 

Returns 

TpDateAndTime 

Raises 

TpCommonExceptions , P_INVALID_TIME_AND_DATE_FORMAT 
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8.3.5 Event Notification Interface Classes 
8.3.5.1 Interface Class IpFwEventNotification 

Inherits from: Iplnterface. 

The event notification mechanism is used to notify the service of generic events that have occurred. If Event 
Notifications are supported by a Framework, this interface and the createNotification() and destroyNotification() 
methods shall be implemented. 

«lnterface» 
IpFwEventNotification 



createNotification (eventCriteria : in TpFwEventCriteria) : TpAssignmentID 
destroyNotification (assignmentID : in TpAssignmentID) : void 



Method 

createNotification () 

This method is used to install generic notifications so that events can be sent to the service. 

Returns <assignmentID> : Specifies the ID assigned by the framework for this newly installed event notification. 

Parameters 

eventCriteria : in TpFwEventCriteria 

Specifies the event specific criteria used by the service to define the event required. 
Returns 

TpAssignmentID 

Raises 

TpCommonExceptions, P_INVALID_EVENT_TYPE, P_INVALID_CRITERIA 



Method 

destroyNotification () 

This method is used by the service to delete generic notifications from the framework. 
Parameters 

assignmentID : in TpAssignmentID 

Specifies the assignment ID given by the framework when the previous createNotification() was called. If the 
assignment ID does not correspond to one of the valid assignment IDs, the framework will return the error code 
P_INVALID_ASSIGNMENT_ID. 
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Raises 

TpCommonExceptions , P_INVALID_ASSIGNMENT_ID 



8.3.5.2 Interface Class IpSvcEventNotification 

Inherits from: Iplnterface. 

This interface is used by the framework to inform the service of a generic event. The Event Notification Framework 
will invoke methods on the Event Notification Service Interface that is specified when the Event Notification interface 
is obtained. If Event Notifications are supported by a Service, this interface and the reportNotification() and 
notificationTerminatedO methods shall be implemented. 

«lnterface» 
IpSvcEventNotification 



reportNotification (eventlnfo : in TpFwEventlnfo, assignmentID : in TpAssignmentID) : void 
notificationTerminated () : void 



Method 

reportNotification ( ) 

This method notifies the service of the arrival of a generic event. 
Parameters 

eventlnfo : in TpFwEventlnfo 

Specifies specific data associated with this event. 

assignmentID : in TpAssignmentID 

Specifies the assignment id which was returned by the framework during the createNotification() method. The service 
can use the assignment id to associate events with event specific criteria and to act accordingly. 

Raises 

TpCommonExceptions , P_INVALID_ASSIGNMENT_ID 



Method 

notificationTerminated ( ) 

This method indicates to the service that all generic event notifications have been terminated (for example, due to faults 
detected). 
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Parameters 

No Parameters were identified for this method 



Raises 



TpCommonExceptions 



8.4 



State Transition Diagrams 



This clause contains the State Transition Diagrams for the objects that implement the Framework interfaces on the 
gateway side. The State Transition Diagrams show the behaviour of these objects. For each state the methods that can 
be invoked by the client are shown. Methods not shown for a specific state are not relevant for that state and will return 
an exception. Apart from the methods that can be invoked by the client also events internal to the gateway or related to 
network events are shown together with the resulting event or action performed by the gateway. These internal events 
are shown between quotation marks. 



8.4.1 



Service Registration State Transition Diagrams 



8.4.1.1 



State Transition Diagrams for IpFwServiceRegistration 




registerService 




unannounce 



Service 



announceS.erviceAvailability 




describeService 



unregi!!terService 
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Figure : State Transition Diagram for IpFwServiceRegistration 



8.4.1 .1 .1 SCF Registered State 

This is the state entered when a Service Capabihty Server (SCS) registers its SCF in the Framework, by informing it of 
the existence of an SCF characterised by a service type and a set of service properties. As a result the Framework 
associates a service ID to this SCF, that will be used to identify it by both sides. 

An SCF may be unregistered, the service ID then being no longer associated with the SCF. 

8.4.1.1.2 SCF Announced State 

This is the state entered when the existence of the SCF has been announced, thus making it available for discovery by 
applications. The SCF can be unannounced at any time, taking it back into the SCF Registered state where it is no 
longer available for discovery. 



8.4.2 Service Instance Lifecycle Manager State Transition Diagrams 



There are no State Transition Diagrams defined for Service Instance Lifecycle Manager 



8.4.3 Service Discovery State Transition Diagrams 



There are no State Transition Diagrams defined for Service Discovery 



8.4.4 



Integrity Management State Transition Diagrams 



8.4.4.1 



State Transition Diagrams for IpFwLoadManager 
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"load change" '^loadLevelNotification 



reportLoad 



createLoadLe\«INotification ^loadLe\«INotification 



Active 



query AppLQadRes[ load statistics requested by LoadManager ] 
queryAppLoadErr[ load statistics requested by LoadManager ] 
query LoadReq 



pAccess^obtalnhterface 
lpAccess>obtal ilrTterfaceWithCallback 




destroyLoadLevel Notification 



suspendNotiflcatlon 
[ all notifications suspended ] 



reportLoad 

query AppLoadRes[ load statistics requested by LoadManager ] 
queryAppLoadErr[ load statistics requested by LoadManager] 
queryLoadReq 



All States 



IpAccess.endAccess 



Figure : State Transition Diagram for ipFwLoadlUlanager 

8.4.4.1.1 Idle State 

In this state the service has obtained an interface reference of the LoadManager from the IpAccess interface. 

8.4.4.1 .2 Notification Suspended State 

Due to e.g. a temporary load condition, the service has requested the LoadManager to suspend sending the load level 
notification information. 

8.4.4.1.3 Active State 

In this state the service has indicated its interest in notifications by performing a createLoadLevelNotification() 
invocation on the IpFwLoadManager. The load manager can now request the service to supply load statistics 
information (by invoking querySvcLoadReqO). Furthermore the LoadManager can request the service to control its 
load (by invoking loadLevelNotification(), resumeNotification() or suspendNotification() on the service side of 
interface). In case the service detects a change in load level, it reports this to the LoadManager by calUng the method 
reportLoad(). 

8.4.5 Event Notification State Transition Diagrams 

There are no State Transition Diagrams defined for Event Notification 
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9 Service Properties 
9.1 Service Property Types 

The service type defines which properties the suppUer of an SCF suppUer shall provide when he registers an SCF. 

At Service Registration the properties of a type shall be interpreted as the set of values that can be supported by the 
service. If a service type has a certain property (e.g. "CAN_DO_SOMETHING"), a service registers with a property value 
of { "true" , " false" } . This means that the SCS is able to support Service instances where this property is used or 
allowed and instances where this property is not used or allowed. This clarifies why sets of values shall be used for the 
property values instead of primitive types. 

At estabhshment of the Service Level Agreement the property can then be set to the value of the specific agreement. 
The context of the Service Level Agreement thus restricts the set of property values of the SCS and will thus lead to a 

sub-set of the service property values. When the correct SCF is instantiated during the discovery and selection 
procedure (see Note), the Service Properties shall thus be interpreted as the requested property values. 

NOTE: This is achieved through the createServiceManager() operation in the Service Instance Lifecycle Manager 
interface. 

All property values are represented by an array of strings. The following table shows all supported property types. 



Property type name 


Description 


Example value (array of 


interpretation of example 
value 


BOOLEAN_SET 


set of Booleans 


{"FALSE"} 


The set of Booleans 
consisting of the Boolean 
"false". 


INTEGER_SET 


set of integers 


|M.^ II 112" "5" "7"} 


The set of integers 
consisting of the integers 1 , 
2, 5 and 7. 


STRING_SET 


set of strings 


{"Sophia", "Rijen"} 


The set of strings consisting 
of the string "Sophia" and the 
string "Rijen" 


ADDRESSRANGE_SET 
(Deprecated) 


set of address ranges 


{"123??*", 
"*.ericsson.se"} 


The set of address ranges 
consisting of ranges 123??* 
and *. ericsson.se. 


INTEGERJNTERVAL 


interval of integers 


{"5", "100"} 


The integers that are 
between or equal to 5 and 
100. 


STRINGJNTERVAL 


interval of strings 


{"Rijen", "Sophia"} 


The strings that are between 
or equal to the strings "Rijen" 
and "Sophia", in 
lexicographical order. 


INTEGERJNTEGER_MAP 


map from integers to 
integers 


{"1", "10", "2", "20", "3", 
"30"} 


The map that maps 1 to 10, 
2 to 20 and 3 to 30. 


XML ADDRESS RANGE 
SET 


set of values of 
TpAddressRange. Values 
of TpAddressRange are 
described using XML. An 
XML schema is provided 
below for this purpose. 


{"<Address RangeSet> 
<AddressRange> 

<Plan>P ADDRESS 

PLAN_E164</Plan> 

<AddrString>123*</Ad 

drString> 

</AddressRange> 

<AddressRange> 

<Plan>P ADDRESS 

PLAN E164</Plan> 

<AddrString>234*</Ad 

drString> 

</AddressRange> 

</AddressRangeSet>"} 


Any addresses starting with 
123 or starting with 456 in 
the E.164 Address Plan 
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The bounds of the string interval and the integer interval types may hold the reserved value "UNBOUNDED". If the left 
bound of the interval holds the value "UNBOUNDED", the lower bound of the interval is the smallest value supported 
by the type. If the right bound of the interval holds the value "UNBOUNDED", the upper bound of the interval is the 
largest value supported by the type. 

The value of XML_ADDRESS_RANGE_SET should comply with the following XML Schema: 
<?xml version="1 .0" encoding="UTF-8"?> 

<xs:schema xmlns:xs="http://www. w3.org/2001/XMLSchema" elementFormDefault="qualified" 
attributeFormDefault="unqualified"> 

<xs:element name="AddressRangeSet"> 
<xs:complexType> 
<xs:sequence> 

<xs:element name="AddressRange" maxOccurs="unbounded"> 
<xs:complexType> 
<xs:sequence> 

<xs:element name="Plan" type="xs:string" default="P_ADDRESS_PLAN_ANY"/> 
<xs:element name="AddrString" type="xs:string"/> 
<xs:element name="Name" type="xs:string" minOccurs="0"/> 
<xs:element name="SubAddressString" type="xs:string" minOccurs="0"/> 
</xs:sequence> 
</xs:complexType> 
</xs:element> 
</xs:sequence> 
</xs:complexType> 
</xs:element> 
</xs:sohema> 



An example usage could be: 

{ "<?xml version="1 .0" encoding="UTF-8"?> 

<AddressRangeSet xmlns:xsi="http://www. w3.org/2001/XMLSchema-instance" 
xsi:noNamespaceSchemaLocation="xml_address_range_set.xsd"> 
<AddressRange> 

<Plan>P_ADDRESS_PLAN_E164</Plan> 

<AddrString>789*</AddrString> 
</AddressRange> 
<AddressRange> 

<Plan>P_ADDRESS_PLAN_ANY</Plan> 

<AddrString>123*</AddrString> 
</AddressRange> 
<AddressRange> 

<Plan>P_ADDRESS_PLAN_SIP</Plan> 

<AddrString><sip:*@parlay.org></AddrString> 

<Name/> 
</AddressRange> 
</AddressRangeSet>"} 

Note that the final address range corresponds to any sip address @parlay.org, i.e. <sip:*@parlay.org>. 



9.2 General Service Properties 

Each service instance has the following general properties: 

• Service Name 

• Service Version 

• Service Instance ID 

• Service Instance Description 

• Product Name 

• Product Version 
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• Supported Interfaces 

• Operation Set 

9.2.1 Service Name 

This property contains the name of the service, e.g. "UserLocation", "UserLocationCamel", "UserLocationEmergency" 
or "UserStatus". 

9.2.2 Service Version 

This property contains the version of the APIs, to which the service is compliant, e.g. "2.1". 

9.2.3 Service Instance ID 

This property uniquely identifies a specific instance of the service. The Framework generates this property. 

9.2.4 Service Instance Description 

This property contains a textual description of the service. 

9.2.5 Product Name 

This property contains the name of the product that provides the service, e.g. "Find It", "Locate.com". 

9.2.6 Product Version 

This property contains the version of the product that provides the service, e.g. "3.1.1 1". 

9.2.7 Supported Interfaces 

This property contains a list of strings with interface names that the service supports, e.g. "IpUserLocation", 
"IpUserStatus". 



9.2.8 Operation Set 



Property 


Type 


Description 


P_OPERATION_SET 


STRING_SET 


Specifies set of tlie operations the SCS supports. 
The notation to be used is : 
{"lnterface1.operation1","lnterface1.operation2", 
"lnterface2.operation1"}, e.g.: 
{"lpCall.createCall","lpCall.routeReq"}. 



10 Data Definitions 

This clause provides the Framework specific data definitions necessary to support the OSA interface specification. 
The general format of a data definition specification is the following: 

- Data type, that shows the name of the data type; 

- Description, that describes the data type; 

- Tabular specification, that specifies the data types and values of the data type; 
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- Example, if relevant, shown to illustrate the data type. 

All data types referenced but not defined in this clause are common data definitions which may be foimd in 
3GPPTS 29.198-2. 

10.1 Common Framework Data Definitions 

10.1.1 TpClientAppID 

This is an identifier for the chent apphcation. It is used to identify the client to the Framework. This data type is 
identical to TpString and is defined as a string of characters that uniquely identifies the apphcation. The content of this 
string shall be unique for each OS A API implementation (or unique for a network operator's domain). This unique 
identifier shall be negotiated with the OSA operator and the application shall use it to identify itself. 

10.1.2 TpClientApplDLIst 

This data type defines a Numbered Set of Data Elements of type TpClientAppID. 

10.1.3 TpDomainID 



Defines the Tagged Choice of Data Elements that specify either the Framework or the type of entity 
attempting to access the Framework. 





^^Bag Element Type 






TpDomainlDType 





P_FW 


TpFwID 


FwID 


P_CLIENT_APPLICATION 


TpClientAppID 


ClientAppID 


P_ENT_OP 


TpEntOpID 


EntOpID 


P_SERVICE_INSTANCE 


TpService Instance ID 


ServicelD 


P_SERVICE_SUPPLIER 


TpServiceSupplierlD 


ServiceSupplierlD 



10.1.4 TpDomainlDType 



Defines either the Framework or the type of entity attempting to access the Framework. 





Value 




P_FW 





The Framework 


P_CLIENT_APPLICATION 


1 


A client application 


P_ENT_OP 


2 


An enterprise operator 


P_SERVICE_INSTANCE 


3 


A service instance 


P_SERVICE_SUPPLIER 


4 


A service supplier 



10.1.5 TpEntOpID 

This data type is identical to TpString and is defined as a string of characters that identifies an enterprise operator. 
In conjunction with the application it uniquely identifies the enterprise operator which uses a particular OSA Service 
Capability Feature (SCF). 

10.1.6 TpPropertyName 

This data type is identical to TpSt r ing. It is the name of a generic "property". 
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10.1.7 TpPropertyValue 

This data type is identical to TpString. It is the value (or the list of values) associated with a generic "property". 

10.1.8 TpProperty 

This data type is a Sequence of Data Elements which describes a generic "property". It is a structured data 

type consisting of tlie following {naine.value } pair: 



Sequence Element 


Sequence Element 


PropertyName 


TpPropertyName 


PropertyValue 


TpPropertyValue 



10.1.9 TpPropertyList 

This datatype defines a Numbered List of Data Elements of type TpProperty. 

10.1.10 TpEntOplDList 

This data type defines a Numbered Set of Data Elements of type TpEntOpID. 

10.1.11 TpFwID 

This data type is identical to TpString and identifies the Framework to a client appUcation (or Service Capability 
Feature) 

10.1.12 TpService 

This data type is a Sequence of Data Elements which describes a registered SCFs. It is a structured type which consists 
of: 



Sequence Element 

NamMMHI 






ServicelD 


TpServicelD 




ServiceDescription 


TpServiceDescription 


This field contains the description of the service 



10.1.13 TpServiceList 

This data type defines a Numbered Set of Data Elements of type TpService. 

10.1.14 TpServiceDescription 

This data type is a Sequence of Data Elements which describes a registered SCF. It is a structured data type which 

consists of: 



HilliliiBBiiiil^^ 



ServiceTypeName 


TpServiceTypeName 




ServicePropertyList 


TpServicePropertyList 
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10.1.15 TpServicelD 

This data type is identical to a TpString, and is defined as a string of characters that uniquely identifies a registered SCF 
interface. The string is automatically generated by the Framework. 

10.1.16 TpServicelDList 

This data type defines a Numbered Set of Data Elements of type TpServicelD. 

10.1.17 TpServicelnstancelD 

This data type is identical to a TpString, and is defined as a string of characters that uniquely identifies an instance of a 
registered SCF interface. The string is automatically generated by the Framework 

10.1.18 TpServiceSpecString 

This data type is identical to a TpString, and is defined as a string of characters that uniquely identifies the name of an 
SCF specialization interface. Other network operator specific capabihties may also be used, but should be preceded by 
the string "SP_". The following values are defined. 







NULL 


An empty (NULL) string indicates no SCF specialization 


P_CALL 


The Call specialization of the of the User Interaction SCF 



10.1.19 TpServiceTypeProperty 

This data type is a Sequence of Data Elements which describes a service property associated with a service 
type. It defines the name and mode of the service property, and also the service property type: e.g. Boolean, integer. 
It is similar to, but distinct from, TpServiceProperty. The latter is associated with an actual service: it defines the 
service property's name and mode, but also defines the list of values assigned to it. 



Sequence Element 


Sequence Element 


Documentation 


ServicePropertyName 


TpServicePropertyName 




ServiceTypePropertyMode 


TpServiceTypePropertyMode 




ServicePropertyTypeName 


TpServiceProperty TypeName 





1 0. 1 .20 TpServiceTypePropertyList 

This data type defines a Numbered Set of Data Elements of type TpServiceTypeProperty. 

10.1.21 TpServiceTypePropertyMode 

This type defines SCF property modes. 







NORMAL 





The value of the corresponding SCF property type may optionally be provided 


MANDATORY 


1 


The value of the corresponding SCF property type shall be provided at service registration time 


READONLY 


2 


The value of the corresponding SCF property type is optional, but once given a value it can not be 
modified/restricted by a service level agreement 


MANDATORY_READONLY 


3 


The value of the corresponding SCF property type shall be provided but can not subsequently be 
modified/restricted by a service level agreement. 
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1 0. 1 .22 TpServicePropertyTypeName 

This data type is identical to TpString and describes a valid SCF property name. The vaUd SCF property names are 
listed in the SCF data definition. 

1 0. 1 .23 TpServicePropertyName 

This data type is identical to TpString. It defines a valid SCF property name. 

1 0. 1 .24 TpServicePropertyNameList 

This data type defines a Numbered Set of Data Elements of type TpServicePropertyName. 

10.1.25 TpServicePropertyValue 

This data type is identical to TpString and describes a valid value of a SCF property. 

1 0. 1 .26 TpServicePropertyValueList 

This data type defines a Numbered Set of Data Elements of type TpServicePropertyValue 



10.1.27 TpServiceProperty 

This data type is a Sequence of Data Elements which describes an "SCF property". It is a structured data type which 
consists of: 



Sequence Element 


Sequence Element 


Documentation 


ServicePropertyName 


TpServicePropertyName 




ServicePropertyValueList 


TpServicePropertyValueList 





1 0. 1 .28 TpServicePropertyList 

This data type defines a Numbered Set of Data Elements of type TpServiceProperty. 

10.1.29 TpServiceSupplierlD 

This is an identifier for a service supplier. It is used to identify the suppher to the Framework. This data type is 
identical to TpString. 

1 0. 1 .30 TpServiceTypeDescription 



This data type is a Sequence of Data Elements which describes an SCF type. It is a structured data type. It consists of: 



Sequence Element 
Name 


Sequence Element 
Type 






ServiceTypePropertyList 


TpServiceTypePropertyList 


a sequence of property name and property mode tuples associated with the 
SCF type 


ServiceTypeNameList 


TpServiceTypeNameList 


the names of the super types of the associated SCF t)'pe 


AvailableOrUnavailable 


TpBoolean 


an indication whether the SCF type is available (true) or unavailable (false) 
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10.1.31 TpServiceTypeName 

This data type is identical to a TpString, and is defined as a string of characters that uniquely identifies the type of an 
SCF interface. Other Network operator specific capabiUties may also be used, but should be preceded by the string 
"SP_". The following values are defined. 





NULL 


An empty (NULL) string indicates no SCF name 


P_GL^,E1<^':_CALL_':0^, _KOL 


The name of the Generic CaU Control SCF 


P_MULTI_PARTY_CALL_CONTROL 


The name of tlie MuItiParty Call Control SCF 


P_MULT I_MED I A_CALL_CONTROL 


The name of the MultiMedia Call Control SCF 


P_CONFERENCE_CALL_CONTROL 


The name of the Conference CaU Control SCF 


P_USER_INTERACTION 


The name of the User Interaction SCFs 


P_TERMINAL_CAP AB I L I T I ES 


The name of the Terminal Capabilities SCF 


P_USER_LOCATION 


The name of the User Location SCF 


P_USER_LOCATION_CAMEL 


The name of the Network User Location SCF 


P_USER_LOCAT I ON_EMERGENC Y 


The name of the User Location Emergency SCF 


P_USER_STATUS 


The name of the User Status SCF 


P_DATA_SE S S ION_CONTROL 


The name of the Data Session Control SCF 


P_GENERIC_MESSAGING 


The name of the Generic Messaging SCF 


P_CONNECTIVITY_MANAGER 


The name of the Connectivity Manager SCF 


P_CHARGING 


The name of the Charging SCF 


P_ACCOUNT_MANAGEMENT 


The name of the Account Management SCF 


P_POL I CY_MANAGEMENT 


The name of the Policy Management SCF 


P_PAM_PRE SENCE_AND_AVAI LABI LI TY 


The name of PAM presentity SCF 


P_PAM_EVENT_MANAGEMENT 


The name of PAM watcher SCF 


P_PAM_PROVI S lONING 


The name of PAM provisioning SCF 


1 0. 1 .32 TpServiceTypeNameList 



This data type defines a Numbered Set of Data Elements of type TpServiceTypeName. 



10.1.33 TpSubjectType 



Defines the subject of a query/notification request/result. 





Value 


Description 


P_SUBJECT_UNDEFINED 





The subject is neither the framework nor the 
chent application 


P_SUBJECT_CLIENT_APP 


1 


The subject is the client application 


P_SUBJECT_FW 


2 


The subject is the framework 
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10.2 Event Notification Data Definitions 
10.2.1 TpFwEventName 



Defines the name of event being notified. 



Name 


Value 


Description 


P_EVENT_FW_NAME_UNDEFINED 





Undefined 


P_EVENT_FW_SERVICE_AVAILABLE 


1 


Notification of SCS(s) available 


P_EVENT_FW_SERVICE_UNAVAILABLE 


2 


Notification of SCS(s) becoming unavailable 



10.2.2 TpFwEventCriteria 



Defines the Tagged Choice of Data Elements that specify the criteria for an event notification to be 
generated. 





^^^Bg Element Type \ 






TpFwEventName 





P_EVENT_FW_NAME_UNDEFINED 


TpString 


EventNameUndef ined 


P_EVENT_FW_ SERVICE_AVAILABLE 


TpServiceTypeNamelist 


ServiceTypeNamelist 


P_EVENT_FW_SERVICE_UNAVAILABLE 


TpServiceTypeNamelist 


UnavailableServiceTypeNameList 



10.2.3 TpFwEventlnfo 

Defines the Tagged Choice of Data Elements that specify the information returned to the application in an 
event notification. 





Tag Element Type 






TpFwEvcntKamc 





P_EVENT_FW_NAME_UNDEFINED 


TpString 


EventNameUndef ined 


P_EVENT_FW_ SERVICE_AVAILABLE 


TpServicelDList 


Service IDLi St 


P_EVENT_FW_SERVICE_UNAVAILABLE 


TpServicelDList 


UnavailableServicelDList 



10.3 Trust and Security IVIanagement Data Definitions 
10.3.1 Tp AccessTy pe 

This data type is identical to a TpString. This identifies the type of access interface requested by the client apphcation. 
If they request P_OSA_ACCESS, then a reference to the IpAccess interface is returned. (Network operators can define 
their own access interfaces to satisfy client requirements for different types of access. These can be selected using the 
TpAccessType, but should be preceded by the string "SP_". The following value is defined: 



String Value 


Description 


P_OSA_ACCESS 


Access using the OSA Access Interfaces: IpAccess and IpCUentAccess 
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1 0.3.2 TpAuthType 

This data type is identical to a TpString. It identifies the type of authentication mechanism requested by the cUent. It 
provides Network operators and clients with the opportunity to use an alternative to the OSA API Level Authentication 
interface. This can for example be an implementation specific authentication mechanism, e.g. CORBA Security, or a 
proprietary Authentication interface supported by the Network Operator. OSA API Level Authentication is the default 
authentication method. Other Network operator specific capabilities may also be used, but should be preceded by the 
string "SP_". The following values are defined: 







P_OSA_AUTHENTICATION 


Authenticate using the OSA API Level Authentication Interfaces: IpAPILevelAuthentication and 

IpClientAPILevelAuthentication 


P_AUTHENTICATION 


Authenticate using the implementation specific authentication mechanism, e.g. CORBA Security. 



10.3.3 TpEncryptionCapability 

This data type is identical to a TpString, and is defined as a string of characters that identify the encryption capabilities 
that could be supported by the framework. Other Network operator specific capabilities may also be used, but should be 
preceded by the string "SP_". Capabilities may be concatenated, using commas (,) as the separation character. The 
following values are defined. 



String Value 


De^^^^^^^^^^^^^^^^^^^^H 


NULL 


An empty (NULL) string indicates no chent capabilities. 


P_DES_56 


A simple transfer of secret information that is shared between the client application and the Framework with protection 

against interception on the link provided hy the DES algorithm with a 56-hit shared secret key. The ECB mode of DES is to 
be used. 


P_DES_128 


A simple transfer of secret information that is shared between the chent entity and the Framework with protection against 
interception on the link provided by the DES algorithm with a 128-bit shared secret key. Use of the P_DES_128 value of 
TpEncryptionCapabihty is deprecated, as DES cannot be used with a 128-bit key. 


P_RSA_512 


A public-key cryptography system providing authentication without prior exchange of secrets using 512-bit keys. 


P_RSA_1024 


A public-key cryptography system providing authentication without prior exchange of secrets using 1024-bit keys. 


P_TDEA 


The Triple-DES or TDEA algorithm with three 56-bit secret keys. The key exchange is handled seperately, and may permit 
use of three, two or only one unique key. The TECB mode of Triple-DES is to be used. 



1 0.3.4 TpEncryptionCapabilityList 

This data type is identical to a TpString. It is a string of multiple TpEncryptionCapability concatenated using a comma 
(,)as the separation character. 

10.3.5 TpEndAccessProperties 

This data type is of type TpPropertyList. It identifies the actions that the Framework should perform when an 
apphcation or service capability feature entity ends its access session (e.g. existing service capabihty or apphcation 
sessions may be stopped, or left rurming). 

10.3.6 TpAuthDomain 



This is Sequence of Data Elements containing all the data necessary to identify a domain: the domain 
identifier, and a reference to the authentication interface of the domain 



1 Sequence Element 


Sequence Element 


Description 


DomainID 


TpDomainID 


Identifies the domain for authentication. This identifier is assigned to the domain during 

the initial contractual agreements, and is valid during the lifetime of the contract. 


Authlnterf ace 


Iplnterf aceRef 


Identifies the authentication interface of the specific entity. This data element has the same 
Ufetime as the domain authentication process, i.e. in principle a new interface reference 
can be provided each time a domain intends to access another. 
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10.3.7 TplnterfaceName 



This data type is identical to a TpString, and is defined as a string of characters that identify the names of the 
Framework SCFs that are to be supported by the OSA API. Other Network operator specific SCFs may also be used, 
but should be preceded by the string "SP_". The following values are defined. 



p 


_LJ ± Ok^\JV thlKl 


The name for the Discovery interface. 


p 


IIj V Jlj iN i IN \J 1 ±C ± 1 ± \Jvi 


The name for the Event Notification interface. 


p 


0AM 


The name for the OA&M interface. 


p 


T nan mzimzippt? 


The name for the Load Manager interface. 


p 


_r rt U -Li 1 1 IriiNrtorLirx 


The name for the Fault Manager interface. 


p 


HEARTBEAT MANAGEMENT 


Trip n:imp for tfip T-Tp^irtHp'it N/'Tniin cTpinpnl" intprtiipp 


p_ 


_serv':ce_agree:-:ea j_:-:aaage:-:ea j 


The name of the Scrviee Agiecmciit Management inteifaee. 


p_ 


_REGISTRATION 


The name for the Service Registration interface. 


p_ 


_ENT_OP_ACCOUNT_MANAGEMENT 


The name for the Service Subscription: Enterprise Operator Account Management 

interface. 


p_ 


_ENT_OP_ACCOUNT_INFO_QUERY 


The name for the Service Subscription: Enterprise Operator Account Information Query 

interface. 


p. 


_SVC_CONTRACT_MANAGEMENT 


The name for the Service Subscription: Service Contract Management interface. 


p_ 


_SVC_CONTRACT_INFO_QUERY 


The name for the Service Subscription: Service Contract Information Query interface. 


p_ 


_CLIENT_APP_MANAGEMENT 


The name for the Service Subscription: Client Application Management interface. 


p_ 


_C L I E N T_AP P_I NF 0_QUE RY 


The name for the Service Subscription: Chent Apphcation Information Query interface. 


p. 


_SVC_PROFILE_MANAGEMENT 


The name for the Service Subscription: Service Profile Management interface. 


p. 


_SVC_PROFILE_INFO_QUERY 


The name for the Service Subscription: Service Profile Information Query interface. 



10.3.8 TplnterfaceNameList 

This data type defines a Numbered Set of Data Elements of type TplnterfaceName. 

10.3.9 TpServiceToken 

This data type is identical to a TpString, and identifies a selected SCF. This is a free format text token returned by the 
Framework, which can be signed as part of a service agreement. This will contain Network operator specific 
information relating to the service level agreement. The serviceToken has a limited Ufetime, which is the same as the 
lifetime of the service agreement in normal conditions. If something goes wrong the serviceToken expires, and any 
method accepting the serviceToken will return an error code (P_INVALID_SERVICE_TOKEN). Service Tokens will 
automatically expire if the client or Framework invokes the endAccess method on the other's corresponding access 
interface. 

10.3.10 TpSignatureAndServiceMgr 

This is a Sequence of Data Elements containing the digital signature of the Framework for the service agreement, and a 

reference to the SCF manager interface of the SCF. 



Sequence Element 
b_ Name 


Sequence Element 


Digit alSignature 


TpOctetSet 


ServiceMgr Inter face 


IpServiceRef 



The digitalSignature is the signed version of a hash of the service token and agreement text given by the client 
apphcation. If no signing algorithm is used, the digitalSignature is the octet sequence of the service token and 
agreement text given by the client apphcation. 

The ServiceMgrlnterface is a reference to the SCF manager interface for the selected SCF. 
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1 0.3.1 1 TpSigningAlgorithm 

This data type is identical to a TpString, and is defined as a string of characters that identify the signing algorithm that 
shall be used. Other Network operator specific capabiUties may also be used, but should be preceded by the string 

"SP_". The following values are defined. 







NULL 


An empty (NULL) string indicates no signing algorithm is required 


P_MD5_RSA_512 


MD5 takes an input message of arbitrary lengtli and produces as output a 128-bit message digest of the input. 
This is then encrypted with the private key under the RSA public-key cryptography system using a 512-bit key. 


P_MD5_RSA_1024 


MD5 takes an input message of arbitrary length and produces as output a 128-bit message digest of the input. 
This is then encrypted with the private key imder the RSA public- key cryptography system using a 1024-bit key 



1 0.4 Integrity Management Data Definitions 

1 0.4. 1 TpActivityTestRes 

This type is identical to TpString and is an implementation specific result. The values in this data type are "Available" 
or "Unavailable". 

1 0.4.2 TpFaultStatsRecord 



This defines the set of records to be returned giving fault information for the requested time period. 



1 Sequence Element 


Sequence Element | 


Period 


TpTimelnterval 


FaultStatsSet 


TpFaultStatsSet 



10.4.3 TpFaultStats 

This defines the sequence of data elements which provide the statistics on a per fault type basis. 



Sequence Element 
Name 


Sequence Element 
Type 


Description 


J aulz 


Tpin-erf i.cej a.ul- 




Occurrences 


Tplnt32 


The number of separate instances of this fault 


MaxDuration 


Tplnt32 


The number of seconds duration of the longest fault 


TotalDuration 


Tplnt32 


The cumulative duration (all occurrences) 


NumberOf Client sAf feet ed 


Tplnt32 


The number of clients informed of the fault by the Fw 



Occurrences is the number of separate instances of this fault during the period. MaxDuration and TotalDuration are the 
number of seconds duration of the longest fault and the cumulative total during the period. NumberOfCUentsAffected is 
the number of clients informed of the fault by the Framework. 



10.4.4 TpFaultStatistics Error 

Defines the error code associated with a failed attempt to retrieve any fault 
statistics information. 



Name 


Value 


Description 


P_FAULT_INFO_ERROR_UNDEFINED 





Undefined error 


P_FAULT_INFO_UNAVAI LABLE 


1 


Fault statistics unavailable 
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10.4.5 TpFaultStatsSet 

This datatype defines a Numbered Set of Data Elements of type TpFaultStats 

10.4.6 TpActivityTestID 

This data type is identical to a Tplnt32, and is used as a token to match activity test requests with their results.. 



10.4.7 TplnterfaceFault 

Defines the cause of the interface fault detected. 



INTERFACE_FAULT_UNDEFINED 





Undefined 


INTERFACE_FAULT_LOCAL_FAILURE 


1 


A fault in the local API software or hardware has been detected 


INTERFACE_FAULT_GATEWAY_FAI LURE 


2 


A fault in the gateway API software or hardware has been detected 


Ia JERt'ACE_t'A^LJ_PROJOCOL_ERROR 




All error in the protocol used on the client-gatewav' link has been detected 



10.4.8 TpSvcUnavai I Reason 



Defines the reason why a SCF is unavailable. 



Name 


Value 


^ Descrlptlor^^^^^^^^^^^^H 


SERVICE_UNAVAILABLE_UNDEFINED 





Undefined 


SERVI CE_UNAVAI LABLE_LOCAL_FAI LURE 


1 


The Local API software or hardware has failed 


SERVI CE_UNAVAI LABLE_GATEWAY_FAI LURE 


2 


The gateway API software or hardware has failed 


SERVI CE_UNAVAI LABLE_OVERLOADED 


3 


The SCF is fully overloaded 


SERVICE_UNAVAILABLE_CLOSED 


4 


The SCF has closed itself (e.g. to protect from fraud or malicious attack) 



10.4.9 TpFwUnavai I Reason 



Defines the reason why the Framework is unavailable. 















FW_UNAVAILABLE_UNDEFINED 





Undefined 


FW_UNAVAI LABLE_LOCAL_FAI LURE 


1 


The Local API software or hardware has failed 


FW_UNAVAI LABLE_GATEWAY_FAI LURE 


2 


The gateway API software or hardware has failed 


FW_UNAVAI LABLE_OVERLOADED 


3 


The Framework is fully overloaded 


FW_UNAVAILABLE_CLOSED 


4 


The Framework has closed itself (e.g. to protect from fraud or malicious attack) 


FVv_^AAvA^LARLE_t'ROJOCOL_RA^L^RL 


5 


The protocol used on the elicnt-gatewa)' link has failed 



10.4.10 TpLoadLevel 

Defines the Sequence of Data Elements that specify load level values. 



Name ^^^^^^^^^^J^^^^B^^^^^^^^J I ii|ilimi 



LOAD_LEVEL_NORMAL 





Normal load 


LOAD_LEVEL_OVERLOAD 


1 


Overload 


LOAD_LEVEL_SEVERE_OVERLOAD 


2 


Severe Overload 
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10.4.11 TpLoadThreshold 



Defines the Sequence of Data Elements that specify the load threshold value. The actual load threshold value is 
appUcation and SCF dependent, so is their relationship with load level. 



Sequence Element 


Sequence Element 


LoadThreshold 


TpFloat 


10.4.12 TpLoadlnitVal 




Defines the Sequence of Data Elements that specify the pair of load level and associated load threshold value. 


Sequence Element 


Sequence Element 


LoadLevel 


TpLoadLevel 


LoadThreshold 


TpLoadThreshold 


10.4.13 TpLoadPolicy 




Defines the load balancing policy. 




^^^^^^^^^^^^fe^ce Element II^^^^^^^^^^H 


^^^^^^^^Bfeice Element 'ril^^^^^^H 


LoadPolicy 


TpString 


10.4.14 TpLoadStatistic 




Defines the Sequence of Data Element s that represents a load statistic record for a specific entity (i.e. 

Framework, service or application) at a specific date and time. 






LoadStatisticEntitylD 


TpLoadStatisticEntitylD 


Time St amp 


TpDateAndTime 


LoadStatisticInf o 


TpLoadStatisticInf o 



10.4.15 TpLoadStatisticList 

Defines a Numbered List of Data Elements of type TpLoadStatistic. 



10.4.16 TpLoadStatisticData 



Defines the Sequence of Data Elements that represents load statistic information 



^^^^^^M Sequence Element Nam^^^^^^^^^H 


^^^^^■i^Bpnce Element j^^^^^^^B 


LoadValue (see Note) 


TpFloat 


LoadLevel 


TpLoadLevel 


NOTE: LoadValue is expressed as a percentage. 
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10.4.17 TpLoadStatisticEntitylD 



Defines the Tagged Choice of Data Elements that specify the type of entity (i.e. service, application or 
Framework) providing load statistics. 











TpLoadStatisticEntityType 





P_LOAD_STATISTICS_FW_TYPE 


TpFwID 


FrameworkID 


P_LOAD_STATISTICS_SVC_TYPE 


TpScrvicclD 




P_LOAD_STATISTICS_APP_TYPE 


TpCUentAppID 


ClientAppID 



1 0.4. 1 8 TpLoadStatisticEntityType 



Defines the type of entity (i.e. service, application or Framework) supplying load statistics. 



Name ^i^^^^^^^^^ 


Value 


Description 


P_LOAD_STATISTICS_FW_TYPE 





Framework-type load statistics 


P_LOAD_S TAT 1ST I CS_S VC_T YPE 


1 


Service-type load statistics 


P_LOAD_STATISTICS_APP_TYPE 


2 


Application-type load statistics 



10.4.19 TpLoadStatisticlnfo 

Defines the Tagged Choice of Data Elements that specify the type of load statistic information (i.e. valid or 
invaUd). 





Tag Element Type 






TpLoadStatisticlntoTypc 





P_LOAD„STATISTICS_VALID 


TpLoadStatisticData 


LoadStatisticData 


P_LOAD_STATISTICS_INVALID 


TpLoadStatisticError 


LoadStatisticError 



10.4.20 TpLoadStatisticlnfoType 



Defines the type of load statistic information (i.e. valid or invalid). 





Value 


..^^—^ Description ^^^^^i 


P_LOAD_S TATISTIC S_VAL I D 





VaUd load statistics 


P_LOAD_S TATISTICS_I NVAL I D 


1 


Invalid load statistics 



10.4.21 TpLoadStatisticError 



Defines the error code associated with a failed attempt to retrieve any load statistics information. 









P_LOAD_INFO_ERROR_UNDEFINED 





Undefined error 


P_LOAD_INFO_UNAVAI LABLE 


1 


Load statistics unavailable 
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10.5 Service Subscription Data Definitions 

10.5.1 TpPropertyName 

This data type is identical to TpString. It is the name of a generic "property". 

1 0.5.2 TpPropertyValue 

This data type is identical to TpString. It is the value (or the list of values) associated with a generic "property". 

1 0.5.3 TpProperty 

This data type is a Sequence of Data Elements which describes a generic "property". It is a structured data 
type consisting of the following {name, value} pair: 



Sequence Element 
Name 


Sequence Element 
Type 


PropertyName 


TpPropertyName 


Property Value 


TpPropertyValue 



10.5.4 TpPropertyLlst 

This data type defines a Numbered List of Data Elements of type TpProperty. 

10.5.5 TpEntOpProperties 

This data type is of type TpPropertyList. It identifies the list of properties associated with an enterprise operator: e.g. 
name, organisation, address, phone, e-mail, fax, payment method (credit card, bank account). 

10.5.6 TpEntOp 

This data type is a Sequence of Data Elements which describes an enterprise operator. It is a structured data 
type, consisting of a unique "enterprise operator ID" and a list of "enterprise operator properties", as follows: 



Sequence Element 
Name 


Sequence Element 
Type 


EntOpID 


TpEntOpID 


EntOpProperties 


TpEntOpProperties 



10.5.7 TpServiceContractID 

This data type is identical to TpString. It uniquely identifies the contract, between an enterprise operator and the 
Framework, for the use of an OSAservice by the enterprise. 

10.5.8 TpServiceContractlDLIst 

This data type defines a Numbered List of Data Elements of type TpServiceContractID. 

10.5.9 TpPersonName 

This data type is identical to TpString. It is the name of a generic "person". 
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10.5.10 TpPostal Address 

This data type is identical to TpString. It is the maiUng address of a generic "person". 

10.5.11 TpTelephoneNumber 

This data type is identical to TpString. It is the telephone number of a generic "person". 

10.5.12 TpEmail 

This data type is identical to TpString. It is the email address of a generic "person". 

10.5.13 TpHomePage 

This data type is identical to TpString. It is the web address of a generic "person". 

10.5.14 TpPersonProperties 

This data type is of type TpPropertyList. It identifies the Ust of additional properties, other than those listed above, that 
can be associated with a generic "person". 

10.5.15 TpPerson 

This data type is a Sequence of Data Elements which describes a generic "person": e.g. a billing contact, a 
service requestor. It is a structured data type which consists of: 



Sequence Elemen^l^^^^^^^^^^^^^^PPRHHH^^^^^^^^^^^^^^I 
Nan^iHMHHiH^^^^^^^^^^^^B Type 


PersonName 


TpPersonName 


PostalAddress 


TpPostalAddress 


TelephoneNumber 


TpTelephoneNumber 


Email 


TpEmail 


HomePage 


TpHomePage 


PersonProperties 


TpPersonProperties 



10.5.16 TpServiceStartDate 

This is of type TpDateAndTime. It identifies the contractual start date and time for the use of an OSA service by an 
enterprise or an enterprise Subscription Assignment Group (SAG). 

10.5.17 TpServiceEndDate 

This is of type TpDateAndTime. It identifies the contractual end date and time for the use of an OSA service by an 
enterprise or an enterprise Subscription Assigrmient Group (SAG). 

10.5.18 TpService Requestor 

This is of type TpPerson. It identifies the enterprise person requesting use of an OSA service: e.g. the enterprise 
operator. 

10.5.19 TpBillingContact 

This is of type TpPerson. It identifies the enterprise person responsible for bilUng issues associated with an enterprise's 
use of an OSA service. 
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1 0.5.20 TpServiceSubscriptionProperties 

This is of type TpServicePropertyList. It specifies a subset of all available service properties and service property 
values that apply to an enterprise's use of an OS A service. 

10.5.21 TpServiceContract 

This data type is a Sequence of Data Elements which represents a service contract. It is a structured data type 
which consists of: 



Sequence Element 
Name 


Sequence Element 
Type 


ServiceContractID 


TpServiceContractID 


ServiceContr act Description 


TpServiceContractDescription 



1 0.5.22 TpServiceContractDescription 

This data type is a Sequence of Data Elements which describes a service contract. This contract should 
conform to a previously negotiated high-level agreement (regarding OSA services, their usage and the price, etc.), if 
any, between the enterprise operator and the framework operator. It is a structured data type which consists of: 



Sequence Element 
Name 


Sequence Element 
Type 


ServiceRequestor 


TpServiceRequestor 


BillingContact 


TpBillingContact 


Service St art Date 


TpServiceStartDate 


ServiceEndDate 


TpServiceEndDate 


ServiceTypeName 


TpServiceTvpeName 


ServicelD 


TpServicelD 


Se rvice Subs criptionPr ope rties 


TpServiceSubscriptionProperties 



1 0.5.23 TpClientAppProperties 

This is of type TpPropertyList. The client application properties is a list of {name, value} pairs, for bilateral agreement 
between the enterprise operator and the Framework. 

10.5.24 TpClientAppDescription 

This data type is a Sequence of Data Elements which describes an enterprise client application. It is a 
structured data type, consisting of a unique "client application ID", password and a list of "client application properties: 



Sequence Element 
Name 


Sequence Element 
Type 


ClientAppID 


TpClientAppID 


ClientAppP rope rties 


TpClientAppProperties 



10.5.25 TpSagID 

This data type is identical to TpString. It uniquely identifies a Subscription Assignment Group (SAG) of client 
applications within an enterprise. 
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10.5.26 TpSaglDList 

This data type defines a Numbered List of Data Elements of type TpSaglD. 

10.5.27 TpSagDescription 

This data type is identical to TpString. It describes a SAG: e.g. a Ust of identifiers of the constituent client 
applications, the purpose of the "grouping". 

10.5.28 TpSag 

This data type is a Sequence of Data Elements which describes a Subscription Assignment Group (SAG) of 
client applications within an enterprise. It is a structured data type consisting of a unique SAG ID and a description: 



Sequence Element 
Name 


Sequence Element 
Type 


SagID 


TpSagID 


SagDe script ion 


TpSagDescription 



10.5.29 TpServiceProfilelD 

This data type is identical to TpString. It uniquely identifies the service profile, which further constrains how an 
enterprise SAG uses an OSA service. 

10.5.30 TpServiceProfilelDList 

This data type defines a Numbered List of Data Elements of type TpServiceProfilelD. 

10.5.31 TpServiceProfile 

This data type is a Sequence of Data Elements which represents a Service Profile. It is a structured data type 
which consists of: 



Sequence Element 
Name 


Sequence Element 
Type 


ServiceProf ilelD 


TpServiceProfilelD 


ServiceProfileDe script ion 


TpServiceProfileDescription 
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1 0.5.32 TpServiceProfileDescription 

This data type is a Sequence of Data Elements which describes a Service Profile. A service contract contains 
one or more Service Profiles, one for each SAG in the enterprise operator domain. A service profile is a restriction of 
the service contract in order to provide restricted service features to a SAG. It is a structured data type which consists 
of: 



Sequence Element 
Name 


Sequence Element 
Type 


ServiceCont ract ID 


TpServiceContractID 


Service St art Date 


TpServiceStartDate 


ServiceEndDate 


TpServiceEndDate 


ServiceTypeName 


TpServiceTvpeName (See Note 1 ) 


Se rvice Subs criptionPr ope rties 


TpServiceSubscriptionProperties 


NOTE: When the Framework returns a TpServiceProfileDescription to the enterprise operator, it should 
set this field to the same value as the corresponding field of the service contract; When the 
enterprise operator passes a TpServiceProfileDescription to the Framework, the Framework 
should ignore the value sent in this field to ensure interoperability; The enterprise operator 
should be required to set the field to the correct value when passing a 
TpServiceProfileDescription to the Framework. 
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1 1 Exception Classes 



The following are the list of exception classes which are used in this interface of the API. 





Description 


P_ACCESS_DENIED 


The client is not currently authenticated with the framework 


P_APPLICATION_NOT_ACTIVATED 


An appUcation is vinauthorised to access information and request 
services with regards to users that have deactivated that particular 

application. 


P_ J ^ P L ^ C J i L_P POP P P i _A J iJ-lP 


.\ duplicate propcrt}' name has hccn received 


P_ILLEGAL_SERVICE_ID 


Illegal Service ID 


P_I LLEGAL_SERVI CE_TYPE 


Illegal Service Type 


P_INVALID_ACCESS_TYPE 


The framework does not support the type of access interface requested 
by the client. 


P_INVALID_ACTIVITY_TEST_ID 


ID does not correspond to a valid activity test request 


P_INVALID_AGREEMENT_TEXT 


InvaUd agreement text 


P_INVAL I D_ENCRYP T I ON_CAP AB I L I T Y 


Invalid encryption capabiUty 


P_INVALID_AUTH_TYPE 


InvaUd type of authentication mechanism 


P_ I NVAL ID_CLIEN T_AP P_I D 


Invalid Client Application ID 


P_I NVAL ID_DOMAIN_ID 


Invalid client ID 


P_I NVAL I D_ENT_OP_I D 


InvaUd Enterprise Operator ID 


P_INVALID_PROPERTY 


The framework does not recognise the property supplied by the cUent 


P_I NVAL I D_S AG_I D 


InvaUd Subscription Assignment Group ID 


P_INVALID_SERVICE_CONTRACT_ID 


InvaUd Service Contract ID 


P_I NVAL ID_SERVICE_ID 


InvaUd service ID 


P_INVAL I D_SERVI CE_PROF I LE_I D 


InvaUd service profile ID 


P_INVAL I D_SERVI CE_TOKEN 


The service token has not been issued, or it has expired. 


P_INVALID_SERVICE_TYPE 


Invalid Service Type 


P_INVALID_SIGNATURE 


InvaUd digital signature 


P_INVALID_SIGNING_ALGORITHM 


InvaUd signing algorithm 


P_MI SS ING_MANDATORY_PROPERTY 


Mandatory Property Missing 


P_NO_ACCEP TABLE_ENCRYP T I ON_CAP AB I L I T 
Y 


An encryption mechanism, which is acceptable to the framework, is 
not supported by the client 


P_PROPERTY_TYPE_MISMATCH 


Property Type Mismatch 


P_SERVICE_ACCESS_DENIED 


The cUent appUcation is not aUowed to access this service. 


P_SERVICE_NOT_ENABLED 


The service ID does not correspond to a service that has been enabled 


P_SERVICE_TYPE_UNAVAILABLE 


The service type is not available according to the Framework. 


P_UNKNOWN_SERVICE_ID 


Unknown Service ID 


P _ .., A P A W A _S P P _ L' P_ i P P 


Linkiiow ii Service Type 



Each exception class contains the following structure: 



Structure Element Name 


Strusilyre.£jfiinfinLTvpe 


. structure Element Description 


Extrainf ormation 


TpString 


Carries extra information to help identify the source of the 
exception, e.g. a parameter name 
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Annex A (normative): 

OMG IDL Description of Framework 

The OMG IDL representation of this interface specification is contained in text files (fw_data.idl, fw_if_access.idl, 
fw_if_app.idl, fw_if_service.idl contained in archive 2919803V490IDL.ZIP) which accompany the present document. 
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